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Want to unlock the power 
of PowerPC “ microprocessors? 

Here’s the key 





Develops R fiiease 


Systa^ 


If you want to crank oul code LhaL really 
screams on PowerPC microprocessor- 
based systems, then it helps to work with 
llie expeas who know the PowerPC 
Architecture 11 * iaside and oul—Motorola, 
Motorola’s Software Development Kits 
for Power Macintosh™ leverage our experi¬ 
ence as one of the creators of the PowerPC 
Architecture, We know how to get the 
highest possible performance out of every 


PowerPC 


member of the PowerPC family, including 
the PowerPC 603™ and PowerPC 604™ 
microprocessors. And we build that exper 
tise into our highly optimizing C/C++ and 
FORTRAN compilers, 'Iheyll streamline 
your code, so your applications run cleaner 
and faster. And that can give them the edge 
in the marketplace. 

And now, when you license a Motorola 
C/C++ or FORTRAN SDK Tor only $349,* 

+ 

MacOS 


you’ll get the complete Apple** MPW environ 
merit, as well as free upgrades for a Tull year. 

So contact Motorola for more informa¬ 
tion, or to order your own Macintosh® SDK. 
And unlock the power inside PowerPC 
microprocessors. 

Call 1-800-347-8384 or 1-512-891-2994 

JnicnKt ppcinfo@pcis %fR.imH,tixn 
WWW: hilpr//www.r»un,c(jii>/t\iwcrPC 
AfiplHmk: nKHUMOftwUfcapplel ink apptc com 
‘Suggested list price in U.S. dntlurs Suhjtx'L Iti diangc. 
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Eddy Award Winner for Best New Developer Tool 

- Mac User Editors Choice Awards r 1993 



X A distinct improvement over ResEdit. 

MacTech / MacTtitor 

“Resorcerers data template system is amazing!* 

- Bill Goodman, author of Compact Pro 

”Nuke ResEdit! Resorcerer is mission-critical for us.* 

— Dave Winer, Userland Frontier 

"The color pixel editors are wonderful! A work of art!* 

- Dave Winzler t author of Microseeds Redux 

"Every Macintosh de veloper should own a copy of Resorcerer.* 

Canard Rosenthal, Aladdin Systems 

“Resorcerer will pay for itself many times over in saved time and effort 

- Mac User review 

"The template that disassembles PICT’s is awesomet* 

- Bill Steinberg, author of Pyro! and PBTools 

“Resorcerer proved indispensible in its own creation!* 

- Doug McKenna, author of Re sorcerer 

* ..a wealth of time-saving tools” 

Mac User Review, Dec . 1992 



Version 1.2.4 


The Resource Editor for the Macintosh Wizard 


ORDERING INFO 


Needs: >Mac Plus, > Sys 4.2, 1MR 
Likes: >Mac Plus, £ Sys 7.0 t 2MB 
32-hit clean, All/X compatible 

Price: $256 (decimal) 
(Educational, quantity, or 
other discounts available) 

Includes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 

Payment: Check, PC's, or Visa/MC 

Extras (call us): 

COD, FedEx, UPS Blue/Red, 

Intemati on a 1 Shi pp i ng 


Downloadable Denios/Updaters: 

AppleLink: Software Sampler 
AOL; Software Lihs/Development 
CompuServe: MACDEWIbols 
or call us. 


* New ‘cicn’, 4 ppat f , *cr§r\ *acur\ 4 plU\ ‘clut’ editors 

* Powerful icon family editing (all 9 icon types) 

* Color pixel anti-aliasing, dithering, and tots more 

* Complete "PICT disassembly and reassembly 
New- L2 Features; * Resource sorting; ROM resource brow sing 

* 120 template field parsing types now supported 

* New- insertion & deletion template field types 

* Text-only ‘PICT* resources 

* Lots of improvements throughout 

* Easier, faster, more Mac-like, and more productive than ResEdit 

* Safer memory-based, not disk-file-based, design and operation 

* All file information and common commands in one easy-to-use window 

* Compares resource files, and even edits your data forks as well 

* Visible, accumulating, editable scrap 

* Searches and opens/marks/selects resources by text content 

* Makes global resource ID or type changes easily and safely 

* Builds resource Files from simple Rez-llke scripts 

* Most editors Do Re/, directly to the clipboard 

* All graphic editors support screen-copying or partial screen-copying 

* Hot-linking Value Converter for editing 32 bits in a dozen formats 

* Its own 32-bit List Mgr can open and edit very large data structures 

* Templates can pre- and post-process any arbitrary data structure 

* Includes nearly 200 templates for common system resources 

* TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 

* Full integrated support for editing color dialogs and menus 

* Try out balloons, ictb s, lists and popups, even create C source code 

* Integrated single-window Hex/Code Editor, with patching, searching 

* Editors for cursors, versions, pictures, bundles, and lots more 

* Well-designed, helpful developer tools being added all the time 

* Relied on by thousands of Macintosh developers around the world 


MATHEMjESTHETTCS, INC. 

P.O.Box 298 • Boulder * CO * 80306-0298 * USA 
Phone: (303) 440-0707 * Fax: (303)440-0504 
AppleLink/AmericaOnline: KESOROERER • Internet: resorcerer@aol.com 














THE STAFF 


for Macintosh 
Programmers & Developers 

IVfecIMi 

MAGAZINE 

A publication of XFIAIN CORPORATION 


How To Communicate With Us 


In this electronic age, ihe urt of communication has become both easier and more complicated. Is it any surprise that wc prefer e-mail? If you have 
any questions, fed free to call us at 805/-191-9797 or fax us at 805/494-9798, 


DEPARTMENTS 

krternd 

eWorld 

Camptficrvr 

AppleLink 

Atncrk , aOniiiK‘ 

Orders, Circulation, 

& Customer Service 

< u stserv iee® maCfech. cam 

MT.CustSve 

71333,1063 

MT.CUSTSVC 

MTCUSTSVC 

Editorial 

tdiic >riil<ef i i raaech .com 

MT.Edtoure 

7133340® 

MT.FDnOUAL 

Mr editors 

Programmer's Utalkngr 1 

pmgtliai k*nge®n uictech .com 

MTI’igQial 

71552,174 

MT.ITtQCiCHAL 

MT PRGCHAL 

Ad Saks 

; k k(Je><cCn lactech .com 

MTAdSaks 

71552,172 

MTADSAIEi 

MTADSALES 

Online Sufiport 

aniine&tmeted i .com 

MT.Online 

- 

- 

- 

Accounting 

acx x h inti ngtfn ia dec h .com 

am n in Ling@x| xluiitu mi 

- 

- 


Marketing 

intrkciing&ulactecl i com 

MT.Mkig 

- 

- 

- 

Press Refcttrs 

pressnieases©maae<.h .com 

piesaiekases@xpiaiiTtt mi 

- 

- 

- 

General 

i nft *4 ti uuiccli .cm n 

infttf}xplain.cixn 

7133M0M 

MACTFCHMAG 

MacTechMag 

Online support area 

hitp://www.imctech.com 

uie shortcut 

MA(TTECH 

fjfjp 

CiO MAOTRU IMACi 

jUPTliIrr l Parties: 

Tltiftl Parties (H-O) 

use keyword* 
MACTECHMAG 


Xplain Corporation 
C hief Executive Officer * Neil Ticklin 
Chief Financial Officer * Andrea J, Snide nmn 
Advertising Executive * Ruth Subrin 
Customer Service * AI Estrada 
Art Director * Judith Chaplin 
Software Engineer * Don Bresec 
Accounting Assistant * Brian Shin 
Marketing Manager * Jeffrey Mesnik 
Network Administrator * Dona I Corcoran 
Administrative Assistant • Susan Pomraniz 

hoard of Advisors * Blake Park, Alan Carsrud, 
Jordan Mattson, Steven Gdler 



Primed on recycled paper. 


PRINTED WITH 

SOYINK 



MacTech Magazine 

MacTech Magazine is grateful to 
the following individuals who 
contribute on a regular basis. We 
entourage other* to share the technology. We 
are dedicated to the distribution of useful 
programming information without regard to 
Apple's developer status f or information on 
submitting articles, ask us for our writers 
kit which includes the terms and conditions 
upon which wc publish articles. 


Cornttibating Fdiiors 
Copland * Steve Ktene, Mindvision 
Database • Liam Bret k 
Internet ■ Jon Wiederspan 
MagkCap/Telescript * Richard Clark, 
General Magic 

MLsc Topics * Erie Gundrum 
Performance Programming * Jim Gtxhee 
Tips & Tidbits (and Technical Editor) * 

Sieve Sisak 


Regular OjtumnLsls 
Gelling Started * Dave Mark 
Programmer's challenge * Bob Boonstra 
Inside Info * Chris Espinosa 
Symantec Top 10 * Symantec Technical 
Support 

Crahh's Apple • Don Crahb 
URLs • Jim Straus 


And our Editors,,. 

Publisher/Editor-in-Chkf * Neil Ticktin 
Managing Editor * Man Neuburg 
Editorial Assistant • John Kawakami 
Editor-aMarge » Scott T Boyd 


llh- rtmto MacTedi, MacTech Magazine, fthcTedi Q>HQM, MjcTuicji; the MacTitforMari k^o. MacTech Web, arxlJavaTtxb are tradmmiks and icgisicivd rnukututa uf Xpfcrin Corporation, 
All ijantenLs ,uv eupypght 19B4-1995 hy Xpbin GxpuraiiuiL Aft rights reserved Trademarks appearing in MacTech Magazine remain tire property of die companies iku I M ild license 


MacTech Magazine (ISSN: 1067-8360 / USPS: 010-227) is published monthly by Xplain Corporation, 850-P Hampshire Road, Westlake Village, GA 
91361‘2800, Voice; 805/494-9797, FAX; 805/494-9798 Domestic subscription rates are $47,00 per year. Canadian subscriptions arc 1 $59.00 per year. All 
other international subscriptions are $97.00 per year. Domestic source ixide disk subscriptions are $77 |>er year. All international disk subscriptions are 
$97,00 a year. Please remil in IJ,S. funds only. Second Class postage is paid aL Thousand Oaks, CA and at additional mailing office. 

POSTMASTER: Send address changes to MacTech Magazine. P.O, Box 5200, Westlake Village, CA 91359-5200. 


emKfwrt 
U S POSTATif 


PERMIT NO 135 
WKJLAND.MUBMO 


Ml® ENCLOSED 


MacTechMaoazink • January 1996 














































































TABLE OF 
CONTENTS 


January I99(> • Volume 12, No. 1 


For Macintosh 
Programmers & Developers 

MbcTech 

MAGAZINE 





SYMANTEC. 



m 

a 








GETTING STARTED 

PowerPlant and Modeless Child Windows 

— By Dam Mark 



CRABB'S APPLE 

Tomorrow’s Developers..., p ,.... # . 21 

— By Don Crabb 

CUTTING EDGE TECHNOLOGIES 

Opening the BeBox ,,, *..,. 25 

A programmers introduction to the Be operating system 

— By Peter Poirebic and Stem Horowitz, Be Inc . 

SYMANTEC TOP to ... *..„ 46 

— By Michael Hopkins, Symantec 

JAVATEOI™ 

Java Rules ......... . .51 

A Java FAQ -— By HUM N. Cooper man and Apamjita Fishman 

FROM THE FACTORY FLOOR 

Java Talk ... . „...55 

— By Daw* Mark 

INTERNET SOLUTIONS 

Becoming a Macintosh Service Provider. . ..58 

Tales from the field — By Brad Scbrick and Eric Bickford 

INTERNET SPECIAL 

Inside HotneDoor ..,........ 60 

Make one web server act like a network of servers — By Alan B. Oppenheimer 

INTERNET DEVELOPMENT 

CGI’s: AppleScript or Frontier? ....*. 65 

Comparing scripting environments for CGI development 

— By Mason Hale 


VIEWPOINT 

4 



NEWSBITS 

98 



DIAUOG BOX 
90 



THE CLASSIFIEDS 
96 



MAIL ORDER STORE 
100 


BOOK REVIEW 

New Apple Guide Authoring Aids... 67 

Three books and accompanying software for Apple Guide authoring 

— By John A J Powers, III, guideWorks, LLC 

NEW APPLE TECHNOLOGY 

Open Doc: Contain Yourself.... . ..71 

Updating applications to work with OpenDoc 

— By Eric Soldan t Apple Developer Technical Support 


PROGRAMMER'S CHALLENGE 

Sliding Hies ........77 

— By Boh Boonsira 

UNIFORM RESOURCE LOCATORS ....89 

By Jim Straus 



ADVERTISER & 
PRODUCT INDEX 
111 



TIPS & TIDBITS 

112 


Jam any 1996 * MacTec:h Magazine 


Taiiu- of Contiwi* 


3 









































Out of circulation for some time now, all of a sudden TMON 
lias reappeared on the scene. Rumors have circulated since 
before WWDC this year that TMON would make its 
reemergenee, only to listen to deafening silence. Well, silent no 
more, TMON's back! Check out http://www.tmon.com 

TMON last saw major work for System 7 compatibility. 
Since then it has had something of a bumpy ride. For example, 
Waldemar Horwat, its author, spent a little time finishing up his 
Ph D, at MIT. ICOM Simulations, tile original publisher, was 
purchased by Viacom. As you might imagine, the media giant 
was a little less interested in a debugger, no matter how great, 
titan in ICOM s multimedia expertise. 

My interest in TMON goes back Lo 198S. 1 was In grad 

schtxil at Texas A&M, discovering how difficult grad schcx)] ran 
be when there's this really cool computer called Macintosh that 
I could spend every waking hour learning u> program. Flipping 
through Maeazine (anyone remember that great rag?) 1 came 
acre >ss a 1 irtef me ni ion < >f G n npUTopta, a Macintt >sl t a >r tferenee 
in Austin, 1 hopped in the car and drove to Austin, 

One banquet-hall-sized room had booths all the way 
around, probably not more than twenty or so altogether. Just 
inside the entrance was a giant, inflatable Macintosh. I was 
having a blast hanging out with fellow Mac enthusiasts when I 
noticed a crowd of especially geeky types gathering around one 
machine. Some extremely animated guy was driving the 
machine while somehow waving his arms around, too. 

I went over antf stared at the screen. What on earth has 
lie done to it?" The windows were all as wide as the monitor, 
and they only moved vertically, anti the contents moved live. 
They didn’t use the standard WDEF, either. “What’s all that 
monospaced gunk in those windows? Wait a minute! I think 
Fill starting to understand, 11 It gradually came into focus - 1 was 
staring at a debugger, unlike anything ! had ever seen. 

Soon after that l purchased my first copy of TMON, and its 
♦served as my debugger of choice ever since. It was a great 
favorite among Blue Meanies during 7*0 development, too. 

One of the great moments in debugging history was the 
moment when tasked the first PowerPC 68K emulator engineer 
whether TMON would work with his emulator. I don’t know 
whether lo describe the It x )k on his face as surprise or fear. It 
certainly belied his confident retort of A YesP Shortly thereafter I 
tried it out on one of the very first PDMs (which later became 
the 6100). Sure enough, it worked fine. It's a mighty odd sight 
to see a low-level debugger, confident as ever that it s 
displaying the detailed state of a 68K chip when there’s not 
really one inside the lx>x,*. 

Now TMON knows about I>oth chips. Most of the tricks iFs 
always known now work for the PowerPC, too - interactive 
assembly (just type it in) and disassembly; live displays of 
processor state, raw memory dumps, low memory (with 
names), and structure templates; and breakpoints and stepping. 


TMON also knows some new tricks* For example, it 
indicates which direction of a branch youll take (just like 
Macsbug has done for a long time). TMON also handles CFM 
fragments. TMON also offers filters on heap windows, so now 
you can limit the blocks displayed by attribute and/or resource 
info. And here's my favorite feature - stepping no longer does 
a screen swap unless ti needs to. 

Now. back to the history lesson* 1 spent some time looking 
carefully at picking up the product right after Viacom purchased 
ICOM. I decided to pass, but Allan Foster of Guru, Inc. got 
interested. After working out an arrangement with Viacom and 
Waldemar, Guru took it on. He did a huge chunk of work on 
it, adding most of die features mentioned above* Just about die 
time it was ready to ship. Mind Vision approached him with an 
offer he couldn’t refuse* and now TMON is shipping under the 
Mind Vision Label* 

Now, no mention of debugging would be complete 
without mentioning two other stalwarts - Macsbug and Jasik* 
Apple's Jim Murphy has recently added a slew of PowerPC 
support items to Macsbug (too many to go into now), and it's 
definitely worth checking out. It's available in the usual places. 

Likewise, Jasik has added some interesting items 
(http://www.jasik.comk Nosy now disassembles PEF containers, 
and has a fancy new resource selection dialog. The Debugger 
handles PowerPC-native watch points, and can read in the 
symfxilic debugging info files created by Nosy s PFF disassembly. 

Debuggers for the Rest of Us 

I’m excited to see the return of TMON. Macintosh developers 
deserve to have all the excellent tools they cart get, and 
professionals should have them all. By and large, they all 
provide far more value than they cosi. In addition, the 
longevity and expertise represented by bilks like Jasik and 
Mind Vision brings a lot more to the table than just a piece of 
debugging software* l know of one developer who bought 
jasik s Debugger just so lie could call Steve with an occasional 
c 111 estion. It s great to see all three def>uggers undeigc n ng activc 
development and support! 

Food For Thought 

In answer to ihc question, "What’s the coolest stuff coming out 
of Apple lately?' 1 I expected to hear about PCI machines ( they're 
fast), tile Color LaserWriter (looks good* good price), or QTVR 
(too cool!), i got the following answer: “Engineers.” Ouch! 

"A new tool for every projeerf - Ctordon Shemian 

Internet. Mention it and maybe your stock price will climb to 
$] iO/share, too! 1 mentioned it. Maybe it s time for an 
acquisition... ^ 
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Radi year, the illegal use of software 
consumes nearly 50% of your potential 
revenues. With the flames of piracy eating 
away at your profits, can you afford not to 
protect your software? 


Software Obtained Illegally, by region, 1393 vs. 1994 


AlricafMWdl® East 

$666,440,105 

392,687,055 

$3,963,527,364 

Asia 

4,350,981,640 

$4,900,882,960 

Europe 


■■I 

$821,992,751 


1,334,894665 

Latin America 


$2,487,360,944 


3,131,455,600 

U.S ./Canada 

Total for i993: 512,8/10,204,124 

$15,212,700,215 

SoufjKf: BSA 


MacHASP* is widely acclaimed ;is the world's 
most advanced software protection solution 
for Macintosh computers, Since 1984, 
thousands of leading Mac and PC developers 
have used over one million Mac HASP and 
HASP keys to protect billions of dollars worth 
of software. Why? Because MadlASP’s 
security, reliability, and ease-ol'-usc led them 
to a simple conclusion: MacHASP is the most 
effective software protection system available. 



Today, more develojiers are choosing 
MacHASP tlian any other software protection 
method. To learn why, and to see how easily 
you can increase your revenues, call now to 
order your MacHASP Developer’s Kit. 

1 - 800 - 223-4277 


ALADDIN 


The Professional's Choice 

North Aladdin Software Security Inc. 

America Tel: (800) 223 4277,3t2-SM s678 

fax; 2I2-Sfa:ft77 
R- mai I: saltish] iasf i ,och \ i 
WWW: libjr/Avww It asp, emu/ 

Inti Office Aladdin Knowledge Systems Ltd. 

Tel: m K:w: W"$ M7 V/% 

K-mai I: alatldlu laddinjoo.il 

United Aladdin Knowledge 

Kingdom Systems UK Ltd. 

Tel: 01753-622266, Rue U1753 622262 

France Ala dd in France SA 

Tel: I 4085988^. Fax: 1412J 9056 
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Building Internet And Other Native PowerPC 
Applications Has Never Been Easier Or Faster. 


SmalltalkAgents® 

Small taikAgents (STA) Is a 
sophisticated rapid applica¬ 
tion development environ¬ 
ment based on a new gen¬ 
eration of the Smalltalk lan¬ 
guage, enabling you to easily deliver double- 
clickable applications. 


Copland Style GUI Look & Feel 


m 

1 • 

-■■■■■- Catalog Palette 

-- 'ft 

37 

11 

Window Framers 


$ 

3 - 

t 

r 



..“11 



*0 Q Ut»l«q Pahdte 

3 31 







l \ 

2 








WDtF 










SITS' 










VEST IKWutiM MT 

1 


■ 



fciA-vfiniMTa.ivfi I'TiTii ■‘■'IIUA 


i 

H 

Lata log Pal otto 

—FTF1 








■it>EF isn Viriitwi flit 









Catalog Palette 

1 - j J] 


■ ■ 


r \ 




VUEF IjnVirulim Ml 


SC 


„ _„ 

_ 



1 

m C dtolOQ Pflloltr* | 












VDEF 1 SO VartoHonflO 




1 



- 

m 


Creating professional quality user interfaces 
is easy with our component parts libraries. 


VisualWorkbench 

Visually manipulate all objects including 
source and design elements using your 
mouse anti keyboard Visually manage 



design and project elements in a “finder- 
like" desktop workspace as fluidly as you 
work with folders and documents on your 
desktop. Interactively build, wire, and inter¬ 
connect reusable components and inter¬ 
faces in an integrated environment, 

GUI Design & Generation 

Live “Drag and Drop" manipulation to build 
your application’s visual interface using 
components that “know” how to behave 
and autoconfigure themselves into an envi¬ 
ronment. Create new components and/or 
wire together existing components that can 



lx.* saved as reusable template designs for 
use in other applications or containers. 

DTP Engine & Word Processor 

STA not only includes a programmable 
word processor component and 
HyperMedia engine, but also a powerful 
report writer that supports embedding of 
any kind of objects, movies, flow's, and 
international text, and page layout. 

C/C++, Pascal Workbench 

Compile, edit, and dynamically link C/C++, 
Pascal, Fortran, and Assembly code directly 
from within our S'lA VisualWorkbench as an 
integrated part of the Smalltalk application 
development process. 

Component-based Architecture 

STA components arc designed tor QpenPoc 



Agere Object System 

MACINTOSH 


and 01 If, and wall give you transparent inte¬ 
gration with Open Doc and OLH when they 
become available. 

Threading & Internet Tools 

STA provides powerful support for Internet 



server as well as client tool development. 
Pre-emptive threading, thread safe libraries 
and classes for TCP/IP protocols are stan¬ 
dard features enabling you to quickly and 
easily deliver custom e-mail, WOT, list-serv¬ 
er, and other dial-up/network related apps. 


PowerPC Support 

STA. provides binary portability across differ¬ 



ent CPUs and Operating Systems, Design 
applications today on one platform and sim¬ 
ply deploy on other platforms as required. 


Contact us aboul our Web Server & 
Client Toolkit at 1-800-296-1339 or at 
<info{» qks.com> or visit our Web site 
http://www.qks.com/, 



Quasar Knowledge Systems, Inc. 

3818 Parkwood Drive 

Bethesda, MD 211814 USA 

Tel: (3011530-4853 Fax: (301) 530^5712 


& Quasar Knowledge Systems, Inc. 1995 All rights reserved. All other brand or product names are trademarks or registered trademarks oi their respective holders 
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GETTING 

STARTED 


By Dave Mark. MacTecb Magazine Regular Contributing Author 

PowerPlant and Modeless Child Windows 



In last month's column, we huilt an 
application that featured windows with 
two push buttons and a scrolling picture 
pane. The first button beeped when 
you clicked it. The second button was 
disabled. This month, well extend the 
PictScroller program. Well enable the 
second button so that when you dick it. 
a new window appears, allowing you to 
select a new picture for the scrolling 
picture pane. 

Thanks once again to Greg Dow for 
all his PowerPlant help. Greg is a real 
friend to this column and has never been 
loo busy to lend a hand. 

Copy Iast Month’s 
PktSc .roller Project 

Start off by making a copy of last 
month's project folder. Rename it 
Pi ctScroller2 or something like that 
This way, if tilings get a little screwy, 
you don’t have to start over from scratch. 
At the very least, you'll be able to start 
from where we left off last month. 

Once your old folder is tucked safety 
away, open up the PictScrollcr2 
folder. Our first step will be to add two 
more PICT resources to die Constructor 
file PictScroller * rsrc* 

* Open up PictScroller.rsrc 
using your favorite resource editor. 

■ Change the resource ID of the existing 
PICT resource from 128 ro 2001 

* Add two more PICT resources to the 
file and change their resource IDs to 
2002 and 2003 

* Save your changes and quit your 
resource editor. 


In addition to the sun PICT from last month's column, I 
added the moon and red car pictures from my Scrapbook. 

Our next step is to edit PictSerol l^r . rsrc using 
Constructor. 

* Double-dick on the file Piet Sc rol 1 e r. r s rc. 

Constructor will open the file PictScroller, rsrc and 
display a window listing all the views in this file. At this point, 
we've got a single view, an LWindow with an id of 1 and the 
name Pier Window. Our first goal is to make a few changes to 
our existing LWindow view. Our second goal is to create a new 
view, an LWindow with 3 radio buttons and a mint PICT frame. 
[jet's start by editing the existing LWindow. 

* Double-dick on the LWindow with the id of 1 {it should be 
the only view listed in the master view list). 

The view editing window for the PictScroller LWindow will 
appear. 

* Double-click on the titlebar of the window embedded in the 
view editing window (the title bar says Piet Scroller ), 

An info window' for the PictScroller window will appear. 
This next step is incredibly important: 

* Change die Class ID field from wind to CpsW 

* Close the PictScroller info window. 

The four letter (ease sensitive!) code tells PowerPlant what 
type of object we are creating. The code 'wind ' corresponds to 
the dass LWindow. That's the class we used last month. This 
month, we'll be subclassing LWindow with a class named 
CPict ScrollerWindow. When you enter the 
CPictScrollerWindow class definition (later in the column), 
you'll see that we create an enum constant with the name 
class_ID and die value ‘CpsW 1 . Each time you create a dass 
that implements a PowerPlant view, you'll enter the class’ 
class_lD axle in the Class ID held in the view's into window. 
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* Double-dick on the LPicture pane (it has a pane id of 1003), 

* When the pane info window appears, change the PICT 
Resource ID to 2001. 


The first of your three PICT resources (the one with the 
resource ID 2001) should now be displayed in the scrolling pane. 

* Close the LPicture pane info window. 

* Double-click the Dialog button (the right burton). 

* Click on the Enabled check box (so that it is cheeked). 

* Change the Ualue Message to 1001. 

* Change the Button Title to Picture.*. 

* Close die button’s pane info window, 

'fhe button will now say Picture... and will no longer be 
disabled. Also, when it is clicked in your application, ii will 
broadcast a message with a value of 1001 to any listeners. 

Now let's add a new view, 

* Close the view editing window for the Pitt Window LWindow. 

* Select New Resource from the Edit menu, 

* When the view naming dialog appears, make sure 
LLUmdom is selected from the popup menu, type Piet 
Selector (Child) in the edit field, and dick the OK button. 


UMi 


Info for UfJindotu "Picture selector" 



Cl ickiny7Dr.lv rag. 

^ TargeUbl* 

□ set select Click 

□ HU* On Suspend 
Q Delay Select 

fs] Eras* On Update 


Yindov Type: 
Yindov Kind: 


Document window 


Yindov Title; [picture Selector 


[~1 Zoom Box 
[Xj Close Box 

□ Size Box 
£3 Title Bar 

□ Resiz abTe 


VDEF H>: [4 
Class ID: [wind 


^ Enabled 
□ Initially Viable 


Window Layer : f Regular ▼ | 
Auto Position : I Off ~ 


Yindov Sizing:- 


User Data:----- 

Width Heiglrt 



Minimum Size: [0 ||o 


User Constant; [0 

liixinium Size: |'1 j| t 


Yindov Ref ton 1 [u 

Standard Size: |-1 j|-t 




_d_ 






Figure I. The info window for the Picture Selector window. 

Next, you'll create the four items that make up this new 
view: three radio buttons and a mini-picture frame. 


A new view editing window will appear. Before we add 
any items to the new view, change the view’s ID to 2000. 

* Close the view editing window, 

* Select L Window 128 in the master view list, then select 

Resource Info from the Edit menu. 

* Change the Resource 10 from 128 to 2000 

* Close the resource info window, 

* Double-click on the Piet Selector view in the master view list. 

A view editing window for view 2000 will appear. 

Nate: Greg Dow uses a numbering convention that 111 try to stick 
to from now on. He numbers all his new views by thousands. 
So his views have IDs like 1000, 2000, 3000, etc. The items 
within a view start at one plus the view ID, That means that the 
items in this new view will be numbered 2001 ( 2002, 2003, etc. If 
you have groups of items (like radio buttons, for example), you 
might want to leave holes in your numbering scheme. For 
example, you might numlser your radio buttons 2001, 2002, and 
2003, then start the next set of items with 2010, 2011, 2012. As 
always, pick a scheme you like and try to be consistent. 

* Double-dick on the window inside the view editing 
window, 

* When the info window appears, change its settings to match 
those shown in Figure 1. 

* Close the info window. 


* Drag an LStdRadioBtmon from the palette window onto the 
Picture Selector window. 

* Double-click the new radio button. 

* When the info window appears, change its settings to match 
those shown in Figure 2. 

* Close tile info window. 



Figure 2. The info window for the Sun radio button 

* Drag a second LStdRadioButton from the palette window 
onto the Picture Selector window, 

* Double-click the new radio button. 

■ When the info window appears, change Its settings to match 
those shown in Figure 3> 

* Close the info window. 
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Announcing . m 

MICROGUARD^ 


Why so many developers are switching to 
MicroGuard copy protection 


# MicroGuard is committed to uncompromising 
technological superiority 


• MicroGuard has now surpassed its own 

technological lead, actually improving on the best 



Technology at its peak" is mir cunmiunem to you. Thai is why we have 
brought you MieroCitiard Pl«s ™ Ami MimoGuafd Hus is 100% 
backwards ctimpatihlr with MicroGiiatfd Hus meaiu MkrtiGuaid 
and MicroCiuarti Phis can he used imerdiangeahh' 

JuM as we peumisedt 


• MicroGuard offers you the 
most sophisticated network 
protection 

Our network pmieciicMi, MicroGuard Net"*, 
is su superior, we had tu hire an Apple network 
engineer to execute <mr sjKX'iikatkitis. 


• MicroGuard is the only key 
developed by Mac 
developers, and is the first 
and only 100% ADB savvy key 


Mk’mGiiarri Hus is everything MiauCuard t\ plus 4M»t encryption, two 
additional passwtwds, 64-Rit Array, 32*byie puhk area. 45% size reduction, 
eofianced counter and more In addition, Mkitkiitaid Plus offers two new 
utilities QuickC uard’ and KasyGuml** alkiw vou to protect vuur 

applications without lout hing your 
source aide. The only feature rh;ii 
is not plus ts the price :*) 


• MicroGuard is the best 
selling Macintosh key in 
the world 

MkioGuaid sells more Macintosh 
lopyfingection keys than anyone else 
In the woridt 


• MicroGuard delivers 
developer support 
within 24 hours 


We have been developing .Mac applications as a seed devebpmem house 
since 198-1 We are rxu a PC protection company that has conic in you 
witli a Mac product MicroGuard is fully ADR .savvy and offers extended 
addressing, Unlike other protection devices, MicroGuartl never clashes 
with other keys, Only MicroGimrd tillers this level of sophistication. 


We will answer any inquiry' you have within 24-htHira* Wc also have a fully loaded 
AppleLink hulictin bcxml which contains all our libraries, tech notes, Q&A and 
nearly everything you'll ever need 1 




(actual size) 





For more information ami to order a Developer's Kit or to receive a free CD ROM about MicroGuard\ / 

please contact us at: WJjjjjf* 

MicroGuard USA: Teh (31)3) 320-1628 * Fax: (303) 320-1599 * AppleJink: M.GUARI) 

International: Tel: (972) 3 558-2345 * Fax: (972) 3 558-2344 * AppleLink: MICROGUARD MaC : 









Info for LStdRadioButton IQ 2002 “Moon" 



□ T-P 

□ Left □ Ri*t 
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Volot Mrs one: 12002 
Initial Valuo: Qfo 

® Off 


] □ Text ttessag* 

Text Traits ID: jo | 

Control Ref Co*: fp | 


EL 


Figure 3- 7Zw fn/b window for the Moon radio button . 

* Drag a third LStdRadioButton from the palette window onto 
the Picture Selector window, 

* Double-dick the new radio button, 

* When the info window appears, change iLs settings to match 
those shown in Figure 4, 

* Close the info window. 


Info for LStdnadtoButtQn 10 2003 “Red ear” =H- 





Left: j*> | V>4th:|80 \ 

HMqht: [« \. -1 


□ Top 
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0 Bottom 


Pane ID: |2003 j □ T*xt l£> E E 

Us*r Cffustut: fo | □ T*wl cw**t*it 0 Visibl* 

CU« ID: jrtwt 

R« 4 * Title: Mcir 

Viluf Htssagt |2003 IPITkI Hfrii-ao* 

Initial VaW: O 0* Text Tn*U ©: |0 

® 011 Ca*<r*l ft*f Cm : |o 

21_12 
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Figure 4, The info window for the Red car radio button . 

As is, these three radio buttons will act independently, 
Thai is, if you click on one to turn it on or off T it will have no 
effect on the others. To fix this problem, we need to group the 
three buttons into a radio button group. 


• Close the info window, 

* Quit Constructor Be sure to save your changes. 


Infp forLPichire IQ 20TO 


Legation: -- 

Th: tOBH: 


Rihdawj Id S*p#rvi*v : 
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Figure 3 The info window for the /.Picture min-pictu reframe. 


That's about it for your Constructor session. Figure 6 
shows my finished Piet Selector view. Notice that none of the 
radio buttons is turned on and that the mini-picture frame is 
just a grey square. Well .set up the buttons and display the 
right picture in our source code, which we'll get to next. 



Figure 6. The finished Pul Selector view. 

Entering hie Source Code 


• Hold down the shift key and select all three of the radio 
huttons. 

* Select Make Radio Group from the Rrrange menu. 

Next, well create the mini-picture frame. 

• Drag an LPicture from the palette window onto the Picture 
Selector window, 

* Double-dick the new LPicture pane. 

» When the info window appears, change iLs settings to match 
those shown in Figure 5, 


Well modify two source code files and add two new source exxie 
files. Well start with some changes to Piet Sc roller. cp. 

* Open the project file Piet Scroller. jl 

* Open the file Piet Sc roller. cp. 

* Add the line: 

tfiMuludii "CPictScrolierWindpw.h" 

immediately after the #include of Piet Sc roller. h. 

CPictScrollerWindow.h contains a brand new class 


10 


PowkhPlant and Modeless Guild Windows 


MacTechMagazinh * January 1996 





































































































































































N ow, through a joint 
development agree¬ 
ment, Symantec and 
Apple TW Computer let you 
produce the fastest Power 
Mac code, 

Symantec C++ for 
Power Macintosh 7 " now 
cotries with MrC— Apples 
new optimizing compiler. 

[ iitlus try-standard 
Nullstone tests show that 



Symantec'Cf-t-Symantec C; 
wHhMrC 


MfctrowtSfkfc 
CodeV'i^rtiof 7 


iiiiiiiai 


(Jode compiled wing Mrdnm an average of 22% faster than code compiled 
with the standard Symantec C++ compiler or Metmwerfa CZode Warrior 7™ 4 


size and color. Organizing 
and navigating a project 
has never been easier. 

In addition, Symantec 
C++s multi-threaded envi- 
ronment gives you die alii li¬ 
ly to edit and write code 
while you compile. And 
our visual architect lets you 
quickly draw the interface. 
Corresponding code ts rhen 
generated automatically. 


when mrc Goes to work, 
Symantec C++ applications Get 22% faster. 


applications compiled with MrC 
run an average of 22% faster. 

develop faster 
Applications faster. 

Not only can you develop rhe 
fastest Power Mac applications, 
you can write them fast, too. 
New AppleScript support lets you 
automate repetitive tasks. While 
the new linker provides last turn¬ 
around for incremental builds. 

With the fully integrated 
class browser, you 11 quickly nav¬ 
igate your C++ class library. 
And support for templates and 
multiple inheritance further 
boosts your productivity. 

ORGANIZE AND MANAGE 


lets you organize and manage 
nested projects. You can 
display hierarchical 
groups as folders within a 
project window for easier 
organization. 

The editor gives you 
unlimited split panes and 
full text formatting- font, 

MkC Compiler 


M 

ft 

+ 
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All in all, Symantec C++ is a 
great way to develop the 
fastest applications for 
Power Mac. 

THREE CDS FOR THE 
PRICE OF ONE. 


AppleScript 

automates the buildproem 

New Incremental Linker 

provides fast incremental builds 

TEMPLATE AND MULTIPLE 
Inheritance Support 

increases productivity 
NESTED PROJECTS AND FOLDERS 
kt you organize and navigate projects 

MULTITHREADED 

Environment 

lets you cdk and write code while compiling 


A i... 
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SYMANTEC 


C++ When you register as a 

Symantec C++ owner, 
you'll be enrolled in the Symantec 
C++ Subscription for Macintosh 
program. Subscribers will auto¬ 
matically receive two free prod¬ 
uct updates (on CD ROM) so 
you’ll always have the latest fea¬ 
tures and tools. 


Learn more about Symantec C+ + on 
the Internet at wwurSymantec, com 
Or call !-S00-6>2S -4777 t Lx tern ion 


The new Project Manager 

Visual Arciiitect 

builds your interface visually 


W22 for more information. \ 
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definition, which well get to in a hit. This is the class with the 
class_ID co ns La nL * CpsW 1 mentioned earlier in the column* 
Last month, we embedded our message handling code in 
PictScroller ,cp. This month* well create a subclass of 
LWindow and handle the messages (like 1001 from the Beep 
button and 1002 from the Picture,,, button) in our new class, 

■ In the function CPPStarterApp () : : CPFStarterApp (), 
add this code at the end: 

IfRe&istrar: :Regi&terClass(CPictScrollerWindow: :class_ID* 

CPictScrollerUlndov::CreatePictSerallerWindovStreaiii] : 

This code registers our new class, passing In the 
class_ID code and a pointer to the member function that 
creates a new object. 

* In CPFStarterApp: ; ObeyCommand (), comment ouL 
these two tines in the cmdNew case of the switch 
statement: 

//LStdButton 'theButton - 

// (LStdButton ')theWindowOFindPaneBylD( 1000 ); 

// theButton >AddL.istener ( this ); 

Since wc will no longer he handling any messages in this 
class, we no longer have to add ourselves as a listener. For the 
same reason, we can delete the function 
CPFStarterApp::ListenToKessage(): 

■ Delete the function 

CPFStarterApp::ListenToHessage(). 

■ Save your changes anti close Lhe source code file* 

* Now open the file PictScroller *h. 

* Comment out the reference to public LListener in the 
first line of the CPFStarterApp class definition: 

class CPFStarterApp : public Lapplicalion 
/‘. public LLi&tener*/ I 

■ Comment out the declaration of i ho member function 
CPFStarterApp::ListenToMessage(). 

//virtual void ListenToMessage( MessageT inMessage, 

// void "ioParam); 

Your next job is to create new source code files to hold 
your new class definition and your new class source code, 

* Create a new source code file, 

* Type in Litis source code: 

//include <LWindowJ>> 

//include <LLietener .h> 

class CPictScrollerWindow : 
public LWindow, 
public LListener ! 

public; 

emm I ciass_Ib ~ 'CpsW 1 ); 


static ePictScrollerWiiKlow* 

CreatePictScroilerlpfifvdowStreara[LStream r iit'5treFim); 
CPictScrollerWiud^w(LStream 'inStream); 
virtual void ListenToMessage(Message! inMessagc. 
void *ioParam): 

virtual Boolean A11ovSuBRentoval[ 

Leommndet “inSubh 

protected: 

Lwindow 'mChildWindow: 

virtual void FlnlshCreateSelf(): 
void DisplayPictSelector0: 
h 

* Save the source code fife as CPictScrollsrtfindow.h, 

* Close the file CPictScrollerWindow,h. 

There are several important things to remember about 
CPictScrollerWindow.h, We are subclassing [.Window 
and LListener. We want to behave like a window and 
support listening to messages (in our case, we want a window 
that responds to control clicks). WeVe removed the listening 
behaviour from the LApplication subclass 
CPFStarterApp and added ii to CPictScrollerWindow, 
Notice the enum constant class_TD with its 
corresponding four byte code 1 CpsWL If you define your own 
class and will be adding listeners to a specific: view, be sure the 
class defines a class_ID and be sure that class_ID code is 
entered in the class ID field for that view in Constructor 

You might he wondering why we modified the class ID 
field in the PictStroller view (the view with the two push 
buttons), but not in the Piet Selector view (the view with the 
three radio buttons). ITtat's because the class ID only matters if 
your controls generate messages and if you add a listener to 
listen to those messages* We won t install listeners for any of 
the radio buttons. See the call UReanimator: : 
LinkListenerToControls(} in CPictScrollerWindow:: 
UisplayPictSelector (), The class 11) acts as a kind of 
linkage, linking message senders to the class rhat wall receive 
those messages. As you’ll see, well handle the radio buttons 
without using listeners, so we didn't need to modify the class 
ID field in the Piet Selector view, 

Let’s get to the CPictScrollerWindow* cp source code, 

* Create another new source code file* 

* Type in this source code (you can ignore lhe comments): 

fi nclude "CPictScrollerWindow,h" 

//include <L$tdControi.h> 

//include <LPieture.h> 

//include <HRearuinator,h> 

Ci'ictScrollurWindow* 

CPictScrol 1 erWiricJow; rCi ea 1 eFictScro 11 erVindovStrearn ( 

LStream ‘inStream) 

// This function gets t ailed to create a new 
// Q*fctScmlkrWinduw object, 

1 

return Inew CPictScrollerWindov{inStream)); 

1 
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CfictScroiletWindow ;3 CfietScrollerWindow( 

LStream *inStrean);LWindow(inStream) 

// Here’s the constructor Notice that we just pass Uie input parameter on to the 
// LWindow constructor. We have added a data member to our LWindow subclass 
// and initialize it here. mChildWindow is a pointer to a Piet Selector window (aka, a 
// child window) if one exists. If you dick in the Picture... hutton, if a child window' 
// exists, it is brought to the front. If the child window does not exist, it is created, 
i 

raChiId Window = nils 

I 


void CPictScrollerWindoitf: :FinishCr^atuSelf () 

// FinishCreateSelfiO overrides its LWindow counterpart anti is called automatically at 
// object construction time. Weil add our two listeners: one tor the Beep button and 
// one for the Picture... button. 

! 

LStdButton ■theButton = (LStdButton 1 ) FindPaneByiDUOGG); 
theButton->AddListener(this): 
theButton = (LStdButton 1 ) FindFaneByIDUOGI ): 
theButton->AddLlstener(this): 

I 


void CPlcLSerollerWindow;sListenToMessaget 
NessageT inMessage. void. ‘ioParamJ 

! 

switch (inftessage) L 
case 1000: 

// Beep if the Beep button is pressed. 

SysEeo.pt 10): 
break; 
case 1001: 

// Open the Piet Selector window if the Picture... button i> pressed. 

DispiayFIctSeleetorO; 
break: 
case 2001: 
case 2002; 
case 2003: \ 

if ((*tlntS2*JioParam) = Button-On) I 

// When Lisiai JbMcssagcO gets called in response to a message from a control, it 
U puts the value of the control in the param ioPaiam. Wc only take an action when a 
// radio button is being turned on. We don't do anything in response to a button 
// being turned off. 

LPictmre *theP1cture = 

(LPicturo*) mGhlidWindow >FindPancByID(20I0); 
if [itiMeasage != tbeFicture >GetPicturelI)() ) I 
thePicture->SetPictm-eID{inHesfiaga); 

Rect pictFrame: 

thePicture->CalcLoca.iFrameReet (pietFrame); 
thePicture->Resl^eImageTo( 

pietFrajne. right - pictFrame.left, 
p]ctFrame,bottom pletFrame,top, false) ; 

the Pic lure >Refresh(): 

L he Pic cure = (LPieturc 4 ) t'indFanebyiDUOO]): 
thePicture >SetFicturelD(inWessage); 
thePicture->Refresh(): 

I 

1 

break; 

I 

1 

I 


void 

CPictScrollerWindov::DieplayPictSelector{) 

I 

// if the Piet Selector window' doesn't exist, well create it 
if (mChildWindow — nil) I 
raChildWindow = LWindow::CreateWindyw(2£HJG* this): 

// This call searches the specified RidL resource (in this case, 201X1) and calls 
// Addlistener for each item in tile KidL A KidL resource is much like a Dill 
// resource It b a list of broadcasting pane IDs, Each of our radio buttons is a 
// broadcasting pane (broadcasts a message). When we grouped the three radio 
// buttons, Constructor created a Ridl. resource listing the three radio button pane 
// IDs C all t jnkUstenerToComrolsO if you have a RmIL, or AtkllistenerO for each 
// broadcasting control if you don’t have a Rich. 

UReanima to r::LInkListene rToCont roia( 
this, mChildWindow. 2000): 

// Gets the pant ID of the picture pane in the scroller w indow 


LPicUirc 'scrpHerPicUre = 

(LPic cure 1 ) FindPaneByID (1003) ; 

LStdKadioButton ‘tfteRadioButton “ 

(LStdRadioButton *)mChildWindow- >FindFsneByID( 
ecrollerPieture->GetPictureID() ): 

// Our Piet scaling code is executed when a message is sent to ListenToMe&sageQ, 

// above This code also calculates which picture should he drawn in the mini frame. 
// To he sure that this code gets executed, we first turn off the appropriate radio 
// button then turn it back on again 

iheRadioButlon >Se t Value ( JiuttonJJff ) ; 
theRadioButton - >SetValue ( Button_0n ) : 
mChildWindow-)Shov() : 

] else I 

mChildWindow-)Select()* 

1 

) 


Boolean CFictScrollerWindow:sAllowSubRemovaK 
LGomsander *inSub) 

// Allow SubKemovalO is called by PowerPlanl (by LWindow LiAttcmpfGotieO and 
ft LWindow "iXjQoseO) w'hen an LWindow is closed. This is the honk where you 
// might put up a "Save Changes” dialog and not close the window if Caned w:ls 
// clicked, fn our case, we won't put up this kind of dialog. Instead, we 1 II just mark 
// the mChildWindow as nil and return true, saying it is OK to delete the child 
// window. It should be noted that AUowSubRcmovaiO is called when any window 
// that has a super-commandcr is dosed (-11 general, all windows will have a super 
// commander - pcrliaps the LApplicalion object). When you dose tile parent 
If window, the AllowsubRemovalQ of the parent window's supercomraander (the 
// LApplicalion object's AlkiW'SubRemovalQ) geLs called. Well learn about sub- and 
// supereomnianders in a future column. 

I 

if (inSub — mChildWindow) f 
mChildWindow = nil; 

\ 

return true: 

I 

* Save the sou rce cod e file as C P i ct S c r o 11 e r W i nd dvj . e p. 

* Select Add lilindoiu from the Project menu to add the 
file to the project. 

* Close the file CPictSc rolXe r Window > c p* 

Running the Pkojec.t 

Ttiafs a!x)ut it. Run die project. If you removed objeds before 
you copied last month's project, you'll have a minute or two to 
wait for the PowerPlant classes to recompile. Once your 
program runs, you 11 see a window similar to the one in Figure 7. 




[ Picture... j 


-■> 



Figure 7 Vie main, FictScroller window, showing two 
push buttons and a scrolling picture. 


( Beep ] 
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Microsoft 





Bring out the best in both worlds. 


Using just one toolset to target multiple platforms, you can 
increase your user base and knock months off your develop¬ 
ment time. With Microsoft* Visual C++'" Cross-Development 
Edition for the Macintosh*, you can reuse up to 90% of your 
code from your Windows-based applications to create the 
same applications for the Macintosh* with the familiar 
Macintosh interface. 

Features Include: 

■ Pori Window^based features easily to the Macintosh, 
including multiple document interface, print preview, and floating 
toolbars. The Windows Portability Library does the work for you, 

■ True native Macintosh programming. Program directly to 
the System 7 API to take advantage of unique Macintosh fea¬ 
tures such as Publish and Subscribe. 

M Recompile for the Mac *: Target both the Windows and 
Macintosh operating systems using just one set of source 
code written to Microsoft Foundation Classes and the 
Microsoft Win32® APL 


■ Power Macintosh "Support: Including a fully optimizing 
compiler and integrated debugger that adapts to the 
PowerPC™chip when displaying information in the register 
contents and disassembly windows, 

■ Code Fragment Support : for the Power Macintosh which 
translates to better code sharing among applications and 
faster, trimmer applications with very little development over¬ 
head, 

■ OLE support: You can now easily port your Win32 and 
MFC OLE applications to the Macintosh using OLE for the 
Macintosh version 2.06. 

■ ODBC support : You can call ODBC directly or use it 
through the appropriate MFC classes. 


For more information: http://www.microsoft.com/visualc 
or call {800)719-5577. 


Microsoft 

WHIRL DO YOU WANT TO CO TO DAY f* 


'This add-on Ido teat requires Visual Ci t far Intel” platforms, available separately. 

01996 Microsoft Corporation Ail rights reserved Microsoft, Visual C++, Win32, Where do you went to go today?, and Windows are either registered imdhmrcrks nr trademarks ol Microsoft 
Corporation in the United States andtor other counthas, Macintosh is a registered trademark anti Power Macintosh js a trademark of Apple Computer. Inc . used under license 
Mac Is a trademark of Apple Computer, Inc Intel is a registered Irarfcmurk of Intel Corporation. PowerPC is a trademark of International Business Machines Corporation 














IMPORT Hr EXPORT + THUMBNAILS -- 36 FILE FORMATS + DISPLAY I IMAGE GUARANTEE 
PRINTING + COMPRESSION + IMAGE PROCESSING + COLOR REDUCTION 


Ultimate Imaging Toolkit 

Aecu&iii provides the u I Lunate imaging toolkit solution 
with tlic highest periurmimcc, moH iurnuiis & platforms, 
most complete Apt ami the host pricing. That is why we 
art; the industry leader and why over 5000 companies 
have chosen AccuSoft lor their imaging needs! 

Performance 

AccuSoft Ikis always hccit known a_s I lie perfijonancc 
Isidei. We know that yon warn the fastest imaging 
possible and lliul/w.rr is never Iasi enough. Thun: lore, wc 
constantly work on improving performance to keep us 
(and you! ahead of the competition. 

Quality 

AccuSoft has become the leader in imaging toolkits due 
to uui unhung commitment to quality. Not just product 
quality,, which can lie seen, in our unique guarantees, Imi 
also service quality from our special 1‘asl delivery 


program, lop-raied technical support and rock-solid 
technology 

Mac & Power Mac 

The Mac versions of the Image Formal Library provides Code 
Resource, files that are compatible with any Macintosh 
development system including ThinkC. MFW, and Code 
Warrior These versions use the same interface as other 
versions lor easy cross-platform development and are 
available For both Mac and Power Mac systems. An XCVfD 
version is also available. 


Cross Phil form 

With tliis toolkit, yoo can sell your applications on 
many different platforms without having to recode the 
imaging portion, AccuSoft'* cross platform design is 
tailored for easy porting, and since we support Al l 
platforms, your product* can he sold to every market. 

Order Today 

<jd[ now mid you can .start writing high pciforniiincc 
imaging applications in less than an limit. Om unique 
'M)t minute delivery program is also (he fastest in the 
hustnessT 


Toil Free: (800)525-3577 

Internet: http://www,accusoft.com 
CompuServe: Go AccuSoft 


Fro Gold 

The Pro Gold versions of our imaging toolkits are unbeatable 
lor pcrlomiancc and special leant res like scale (o gray, sub- 
degree rotation, sub-second decompress & display, sub- 
second screen rotation, huge image handling and more If you 
w ant the best performance available anywhere, at any price, 
this is it 


Platforms Sirnnoifori Motmtosh I'ot^i Macintosh 
Windows WinfWf D0S.C0S32 VBX.OCX, DS/2, 

I i;id J rfj. SUN US. Solans HP-UX Aix.ii ix. SCO 
Over as File Formats Supported MAC. MliJPtC 
Group III, Grant iv.PCX.TGA DIB, DQ GIF*, BMP W 
PICT,WPG TPS'.KfX BLL, LV CALS, Al I, CLP, XWU, 
IMG, IFF, SUN, XBM ICO, IfiCA, GX2. XPM ASCII CUT, 
CRK, PSD. MSI 3 . PMG^, PliULu 



Liw* Uu the AccuSoft 
trmgtr Guarantee tm or 
m AccuSoft tmctonai* 
on your favorite soflwar* 

frir'H tur;SS ji£ a iafriunmnl 
of superior quakiy 



/MNUT6 

Delivery 


You mo staii listing r/Ws 

AccuSoft fim'tjtrX Unlay 
try laktntj HrtvirnturjH 
Ot our unique Ci£t Mirnife 
Ltettvery Program 


AccuSoft 

High Performance Imaging' 


Two Westbnrough Business Park Westborough, [VIA 01581 Tel 1508) 898-2770 PAX (508) 898-9662 

All -i is lit! punt sinil hiuml Mjnfc-x air nuk:iil{aiii iir r.'iMJ^rt'd ll;ulrni;nk\ ol 1lis:ii I LAfk-'tliVL: uwlliCrv 

OI«S Aii'uSoli i\w|kkrn1ltni All ftightt 1 !, „i .1 'Avalial^L- »nh In-. Bin % I'm-,,- ttttf 1 'pf rail*' Im til uvu I'Mti kibe lljlllM PtH'tlt thmwt InU.lh I 1 H.-.nl i-uPt ilXvt Not 11*1 |ii m- a tq w W B! I HI Ki»l.il.) 


Click on tiie Beep button. You should hear a beep. Click 
on the Picture... button. A Picture Selector window should 
appear (Figure 8), Click on a few radio buttons and verify tiiai 
the picture changes in both the mini-frame and in the 
PictScroller window. Click on the PictScroller window to bring 
iL to the front. Click on the Picture... button again. Notice 
that the Picture Selector window came to the front, as opposed 
to the program creating a new one. 


button to bring up a second Picture Selector window, Click on 
radio buttons in each Picture Selector window to convince 
yourself Lhat each is Lied only to its ow n parent window. Now- 
dose one of the PictScroller windows. Notice that that 
window's Picture Selector window also disappears!!! As I said 
in the program comments, this all has to do with commanders, 
sufxommanders, and supercommanders. We'll get into all that 
in Future columns. 


IBs Picture Selector 



® Sun 
O Moon 
O Red car 


Figure 8\ The Picture Selector window , 


Select Neiu from the File menu and create a second 
PictScroller window. Click on that window's Picture.,. 


Till Next Month.*, 

Well, that's about it for PictScroller. I think we ll start next 
month s column with a brand new program. See you then,,. 

m 


TO RECEIVE INFORMATION ON ANY PRODUCTS 
ADVERTISED IN THIS ISSUE, 

SEND YOlll REQUEST VIA INTERNET; 
PRODUClTNFO@XPLAIN.COM 
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Measure 

your application development time 

with a 



instead 
of a 


Pictorius brings real Power and Productivity to RAD "XT 

The Test Drive CD-ROM contains limited-use versions of Prograph CPX and Peregrine and Prograph Classic Freeware 

If tin' Test Drive CD-ROM is missing, call us at 1-800-927 4847 and we'll rush line to you 


P NtK4Hrt.PI t 

I cpx 

* ancTCMHua; product 

Hu itd applications 
as fast as you am risuali~e them 

MINIS 

IiSk S hwhsMv. Ghipiu ii 
FRHK YMK UK 111*1 WITS AMI St'miKT 



Build dimt/senvr (/{plications and databases 
as fast as you can visualize them. 

BONIS 

te YEAH Itf IIHttffES ASIl Sl'I'hlkT 
Fkh: 411 Datakam: Mii.matiiis Turn 


“...aprogram written in Prograph 
typically takes about one-third to one-half 
of the programming lime needed to write 
an equivalent program in a textual 
language like C... 

Prograph allows for rapid 
program development with a minimum 
of effort and debugging." 

t)n. Surrr B, Stunman 
MtfTm M 


‘ ‘We're an Oracle shop 
and it's usually a huge effort to build 
a customized front-end hut Peregrine makes 
that a lot easier. With the automatic 
generation of input and output windows, 
we can have an app in IS minutes that’s 
ready for testing and customizing.” 

I Jaws Mrftwtuo 

Senior Technical SmmisT, 

ITT IlUiTRtRli 

pictorius 

A INCORPORATED 


1 i'UUUMAPH • 

classic 


Introduce yourself to visual. 
objecForkmtetl development with 
Prograpb Classic Freeware. 

Prograph Classic freeware 
is a great introduction 
to tiie Prograph world 
of rapid application development. 

Upgrade to Prograph CPX 
when you’re ready for 
professional level application 
development. 



Mac'OS 


Pushing the Limits of Productivity 

1-800-927-4S47 wvAv.pictorius.com sales@[)!Ctoriu5xofn 

System Requirement^; Peregrine requires ;l Power Mac or Macintosh (68040 nr better) with System nf hlgjver. 20 MB of HAM and a ISMIJ [Kirtllioti, 43 MO of httrd dUk Pmgfsph CPX requires 
a 6 S 020 or greater imidiine with System 6 . 0.7 or higher. Minimum 7MB partition and 17MB nf disk spnee. Pro^raph Classic requires a Mac Plus or belter with lM ( a haul disk ami 2 MB HAM. 

Au. TKWtMMtKS AND Ktt&TKKED TKAIRMASficS m. PHliPKk [*113 CUT THEJK RESPECTIVE CDMFftNUiS 






NEW BOOKS FOR MACINTOSH DEVELOPERS FRO 



DAVE MARK 


T EARN 



Macintosh 

sitt.oND Edition 

> 


♦ -tl tt w.Hwwrt 1 * r.-napUrf 


by Dave Mark 

Anyone who can use a Mac can (earn C, and 
all the Information needed to do it is right here! 
Learn C on the Macintosh, Second Edition j has 
been revised and updated to include fresh code, 
enhanced lessons, and a CD-ROM with Metrowerks 
CodeWorrior Lite and an assart men! of games, 
shareware, graphics, and plenty of other neat stuff. 
Book/CD-ROM, 496 pages 


m 

© 

Danny Goodmans 

Apple Guide 
Starter Kit 

V 

'm 1 ' 

Dmnv Goodman 
Jeremy Joan Hcwes 



by Danny Goodman 
and Jeremy Joan Hewes 

Iwa highly respected experts offer a different 
approach for creating your own Apple Guide 
databases* With this program, you can make 
guides quickly and easily, without Having to 
learn a scripting language, write coded files, 
or use several different files and programs to 
produce your dal abase. The authors provide 
advice and tips on how to design a good Guide, 
from planning through testing, revising, and 
indexing. 

Book/disk, 320 pages 



by Joe Zobkiw 

Here's some practical help for creating code 
resources and code fragments for the Macintosh 
and Power Macintosh. Rather than gathering and 
indexing code, the author teaches you more ahoul 
how the Macintosh system functions as a whole. 

He also provides hard to find information about 
techniques used to structure and build fat, safe 
lot, and accelerated code resources for use on both 
630x0 and Power Macintosh* All code is reusable 
and is provided on the disc, along with Metrowerks 
CodeWamor Lite. 

Book/CD-ROM, 528 pages 



by Jon Wiederspon 

and Chuck Shofton 

This hook is a definitive guide to setting up 
and running a Web site oil the Macintosh, 
written by two acknowledged experts in the 
field. It skillfully teaches you everything you 
need to know about using WebSTAR, the best 
known HTTP server software and its shareware 
predecessor MocHTTP, as well os about writing 
CGI applications for your server. A special 
version of WebSTAR, plus Ions of useful 
software, ore on the CD-ROM. 
Book/CD-ROM, 384 pages 


Auva r.a'J Color Imaging 
it;; the \i,lC OS 



by Apple Computer, Inc. 

This is the official guide for enhancing your 
Macintosh software's color capabilities. Covering 
the Color Picker, the CatorSync Manager, the 
Pa lotto Manager, and the Color Manager, the book 
provides conceptual information and code samples. 
Its campon ion CD-ROM offers n complete reference 
to the data structures, routines, and resources 
described in the hook and contains a sample 
application demonstrating ColorSync programming 
techniques* 

Book/CD-ROM, 352 pages 


Macintosh Programmer's 


TOOL 



by Apple Computer, Inc. 

Have you ever needed to find current information 
about using a crucial toolbox call while in the 
middle of writing your application? Now wilh just 
a dick of your mouse, you can get inslanl access 
to more than 5,000 toolbox calls. This CD-ROM 
database contains all routines, data structures, 
and constants as documented in inside Macintosh. 
With a lightening fa si search engine, it helps you 
find key data structures, resources, constants, and 
functions when you need them the most. 
CD-ROM 
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by Bill Hensler 

Sex, lies, and Video Gomes is written for the 
wannobe gomes writer locked inside every Mac 
programmer. This booh provides a leum-by- 
exompte tutorial on the ins and outs of Mac 
arcade-style game programming in G It teaches 
game programming lore, including basic game 
theory, sprite animation, sound, and interaction 
techniques. This book is a mu si-read for serious 
programmers and hobbyists alike. 
Book/disk, 496 pages 


by Bruce Tognatzini 

Respected industry futurist, Bruce Tog' 1 
Tog nan ini, presents his vision of our 
technological future, detailing the steps 
computer professionals need la lake to deliver 
new technologies that will profit the industry 
and benefit society in general This book 
contains Tog's insights on a wide range 
of topics from quality management la the 
meaning of standards, and responses to 
queries supplied by designers and developers. 
432 pages 


by Apple Computer, Inc* 

This is the official reference for the implemen¬ 
tation of OpenDoc on the Mac OS. The book 
describes the component software revolution 
and explains how to develop for it on the 
Mac OS platform. An accompanying CD-ROM 
conlains a complete reference to the OpenDoc 
programming interface, and an extensive 
collection af tested, reusable sample code. 
Book/CD-ROM, 688 pages 



by Apple Computer, Inc. 

Now the 25-booh Inside Macintosh series is 
available on one CD, Inside Macintosh CD “ROM 
contains the electronic text for 25 books from 
Inside Macintosh —the essential resource for 
programmers, designers, and engineers. You can 
have instant access to more than 16,000 pages 
of informa Iron contained in the Inside Macintosh 
suite, including the QuickDraw OX library. 
CD-ROM 


Also Available; 

APPLE GUIDE COMPLETE 
by Apple Computer, Inc. 

Book/CD-ROM, 544 pages 


ORDER THESE BOOKS AND CD'S FROM MACTECH MAIL ORDER STORE NOW!! 


MacTech Mail Order Store 


Title 

Retail Price 

Special Discounted Price 

Mark, Learn C an the Macintosh, Second Edition 

S34.95 

$31.44 

Zobkiw, A Fragment of Your Imagination 

S39.95 

$35.96 

Apple, Advanced Color Imaging on the Mac OS 

$36.95 

$33.26 

Hensler, Sex, Lies, and Video Games 

$34.95 

$31.46 

Tognazzini, Tog on Software Design 

$29.95 

$26.96 

Apple, OpenDoc Programmer's Guide 

$44.95 

$40.46 

Goodman/Hewes, Apple Guide Starter Kit 

$34.95 

$31.46 

Wtederspan/Shattan, Plan, and Manag. Web Sites on the Mac 

$39.95 

$35.96 

Apple, Mac Programmer's Toolbox CD-ROM 

— 

$99.95 

Apple, Inside Macintosh CD-ROM 


$99.95 

Apple, Apple Guide Complete 

$39.95 

$35.96 


All of the above boob and MORE, are listed in the MacTech Mail Order Store 
at these Special Discounted Prices. 

Order by Mail, Telephone, Fax, or E-Mail at the following addresses: 



P.Q. Bet 5700 

Westlake Village, CA 91359-5200 
Voice (805) 494-9797 
Fax{80S)494-9798 


AppleLink: MT.CUSTSVC 
CompuServe: 71333,1063 
Internet: mstsemce@xplain.cam 
America Online: MT CUSTSVC 
eWorld: MT.CuslSvc 


You may use your VISA, MasterCard or American Express; or you may send check or money order (in US funds only). Don't forget 
to Include your name, address and phone number with each order, (California residents only, add 7.25% tax to your order.) 
































Power Too Abundant to Meter 



http: // www.neologic.com/ - neologic/ 
Download the Architectural Overview! 


Scalable 

NeoShare extends the core features of 
NeoAccess to client/server applications. 
NeoShare includes the NeoAccess Toolkit and 
everything you need to create data intensive 
distributed applications. Its advanced 
client/server architecture provides shared access 
to objects by multiple networked clients. 
Combine client and server functions into a 
single application or create separate client and 
server applications. With NeoShare you have 
complete flexibility in the design of your 
distributed systems. 


Proven 

Thousands of commercial and in-house 
developers have already found that NeoLogics 
technology enabled them to build fast, 
powerful applications in record time. That's 
why NeoAccess and NeoShare based 
applications are already operating on millions 
of computers. Tap into the power for your next 
development project! 

neodogic 

Powering Development of Object-Oriented Applications 
NeoLogic Systems 1450 Fourth 5t„ Suite 12 v. 510 , 524.5897 

neoiogic^neologk.com Berkeley, CA 9^710 1 510 . 524.4501 


Cross Platform 

Others may promise cross-platform 
development tools—NeoLogic delivers. 
NeoAccess is a set of C++ classes designed for 
use with popular compilers and application 
frameworks on Windows' 5 ', Macintosh*, and 
Unix " platforms. Full source code is included 
so it can even be used with custom frameworks. 


New in NeoAccess Version 4.0 

NeoAccess now supports Microsoft Visual C++ 
4.0 IDE. MFC 4.0 and the la lest version of 
Metrpwerks CodeWarrior A new stored query 
class increases speed and flexibility in accessing 
objects. Inverted indices and full word search " 
capabilities ease working with many-to-many 
relationships. And all new on-line Hyper- 
Reference guide, documentation, tutorial, and 
sample applications get you up to speed quicklv 
and provide a complete set of reference material. 


Powerful 

NeoAccess and NeoShare are the most powerful 
object-oriented database engines available. They 
display electrifying performance—up to ten 
times that of competitors. Behind an elegant 
programming interface is a high performance 
query engine utilizing: extended Dinary lives 
and binary search algorithms tuned for short 
access times, dynamically combined, collapsed, 
and compressed indices, and object caching for 
lightning fast access to previously used objects. 


No Runtime Fees 

Gel the power of NeoAccess and NeoShare, and 
avoid the expense and administrative hassle of 
feeding the runtime fees meter You pay one 
affordable price no matter how many copies of 
your application you sell or use 
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CRABB'S 

APPLE 


By Don Crabb 


Tomorrow’s Developers 



I just spent a surprisingly enjoyable two 
days as a presenter and keynoter at the 
10th Annual Illinois Computing Educators 
conference in Addison, Illinois, outside 
Chicago. At this conference, today's K-12 
educators met to discuss the latest 
computer software and hardware, the 
lastest trends in computing pedagogy, the 
latest methods in computer laboratory 
management, and the lastest methods for 
moving their kids onto the Internet and 
the World Wide Web. 

[ say “surprisingly enjoyable t H 
because 1 found myself learning just as 
much about the state of Illinois K-12 
computer education as I laught about ihe 
state of current computing technology 
and programming environments, 

f learned that many of It m lay’s kids, 
especially those in grades 7-12, are 
chomping at the bit to learn the guts of 
computing, how and why it works, and 
not just how much fun it can he. These 
expectations cut across racial and 
socioeconomic groups. This information 
counters the widely-reported stereotype 
that only needy white boys from wealthy 
suburban families are really interested in 
learning computer programming, 
computer architecture, computer 
networking, and software engineering, 
What the thousand or so assembled 
teachers taught me was to forget that 
perception as they told me one story after 
another about inner city African- 


American, Hispanic, Asian, and other poor minority kids (girls and 
boys) who stayed lifter schtxjl just to have a bit more time to use 
meager computer resources. And just how many of these kids 
were not just computer-dexxlling, or banging the Internet and 
WWW for die hell of it. These kids am demanding to be taught 
how to put computer technology to use for themselves and their 
families and how to buy into the digital revolution. 

And damnit, we re the folks who ought to stepping up 
to die task to make it happen. 

Despite the best intentions, programs, and efforts of the 
teachers 1 talked with, the minority kids just aren't getting die 
programming training they want and need. Despite the best 
intentions, programs, and efforts of the school administrators 1 
talked with, the inner dty kids just aren't getting the programming 
training they want and need. Despite the best intentions, programs, 
and efforts of the corporate donors I talked with, the poor schools 
just aren't getting die computer and networking resources they 
want and need. And despite the best intentions, programs, and 
efforts of the governmental educational chiefs I talked with, die 
poor, minority, inner dty kids are being overtly and covertly 
locked out oF the digital revolution that is reshaping America. 

And damn it, we’re the folks who ought to be stepping up 
to the task to help fix these problems. 

Tills is no longer just an educational problem. It s a problem of 
the future of this country. Computing and digital information 
pr<x:essing are the wave of the present and the wave of the future. 
For as long as any prognosticators can see. And if we don t start 
digitally enfranchising all of our kids now\ regardless of their race, 
or how much money iheir families make, or what schcx>l they go 
to. we : re going to create a caste system worse than any imagined in 
colonial India under the Raj. We re going to create a country where 
the. 1 haves and the havenors are nor defined so much by bucks as 
by bytes. The digital literati versus the digitally disadvantaged. 

And damn it, we're the folks who ought to be stepping up 
to the task of providing the guidance, the resources, and the 


About Don Crabb -Don is a contributing editor and columnist for MacTech, Mac WEEK, MacUSER, Mac/Cbicago, MacToday, 
Wtn ( )5L ! ser ComputvrUset\ The Chicago Sms-Times Features Syndicate The Springfield Union-News, PC Magazine, and about a 
million other publications, Don welcomes comments at his Internet address: don_crabb@mactech.com. You can also check 
out liis WWW Home page at http://www.cs.uchicago.edu/~decc/. 
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"ScriptXj 

unquestionably has the potential 
to become multimedia's PostScript." —Digital Media* 

Unquestionably, the Premier Multimedia Platform. 


ScriptX'allaws you to develop fot Macintosh, Windows, 

and OS/2 systems ot Hie some time. And to ship single titles for all. 

Unquestionably Advanced. 

With ScriptX you con develop titles impossible to create with other development tools. 

Unquestionably R eusable. 

ScriptX object-oriented design mokes it simple to reuse ., 
your code. Objects can be perfectly synchronized and are \ 
easily moveoble, even across the Internet. v 

Any Questions? 

Call for FREE information, or to boy our ScriptX 
Longuoge Kit for $795, with our notele 6[k)oy 
money back guarantee. 


1-800-652-5343 

http;//www Jcaletdo. com/ 



peoplepower to give our educators the tools and software they 
need u> extend the digital domain to all K-12 students, not just 
those with the fancy multimedia PowerMac setup in the media 
room at home. 

What I am suggesting here is simple, but executing it will 
require a real committment on the part of individuals and their 
companies. Here we go: 

1. Mac developers as a group are among the best programmers 
on the planer, 'that's nor a boast, it's a fact. Mac hardware 
and software companies as a group are among the most 
innovative corporations you can find. That's also not a boast, 
it T s a reality forced on them by a MacOS marker that often 
defies description, and by their primary partner (Apple) that 
frequently defies logic. 

2 * Mac developers need a cause to rally around beside defeating 
Microsoft or learning to he codependent with them. 

3. The 1J.S. is at a crossroads in its ability to provide a proper 
computing education for all of its schoolage kids. 

4 Mac developers and their companies need to get involved 
supporting K-12 computer education efforts in tire U.S., by 
offering their expertise, pro bonce on how to improve and 
extend programming and computer engineering curricula; by 
offering their services, pro bone, at leaching tire teachers; by 
offering their spare time, pro bono, towards creating killer 
computer pedagocial apps to help the haveners catch up 


with die haves; and by offering donations of equipment, 
networking resources, and software to make all [if these 
initiatives work together. 

fn short, what I am suggesting here is the private equivalent 
of a Vista or Peace Corps for all American kids revolving around 
digital technology, with a strong emphasis on programming and 
software development as keys to understanding how the digital 
world is working and will w r ork and how to make the most of it. 
Software and hardware companies would grant paid release time 
to their developers to work in this program and release time to 
their managers to establish it, staff it, and get it under way. 

Naturally, we d buttonhole Apple to be the corporate 
bandwagon upon which we could hitch our pedagocial wagons. 

Let's call this new initiative Lhe Digital Corps of America 
(the idea makes sense in many other countries, too). If you are 
interested in discussing this concept and want to help organize 
it, drop me a line at decc@CS.udiicago.edu. 1 will try to organize 
some electronic meeting forum or list to kick tilings off. 

In the long run, with the Digital Corps of America we end 
up helping to “re-melt the pot" Americans are so fond of 
thinking represents the American Way, but in a way that makes 
sense in die Digital Age. And vve help firmly establish the very 
computer markets we are now r trying to niche out in our duly 
struggles by creating a wdiole new class of computer literate 
customers. Sounds like a win-w in to me, A 
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CUTTING EDGE 
TECHNOLOGIES 


By Peter Potrebic and Steve Horowitz, Be Inc. 



Opening the BeBox 


A programmer’s 
introduction to the Be 
operating system 


Introduction 

Be, Inc. was founded in 1990 by j cari¬ 
bou is Gassee, former president of Apple 
Products, to design and build a new 
computing platform. The first product 
offered by the company is a 
multiprocessing computer called the 
BeBox. It contains two PowerPC 603 
processors and a new, modern 
operating system* 

This article will describe some of 
the philosophy behind the design of the 
BeBox. ll will go into some detail 
explaining the system software 
architecture with an overview of the key 
components. The article also includes 
source code and a description of a 
sample application, to give you a feel 
for writing software on the BeBox. For 
more detailed information on Be and 
the BeBox, as well as a look at 
developer documentation, please visit 
our web site: http://www.be.com. 


Design Philosophy 

The BeBox was designed with the technology enthusiast in 
mind. As Jean-Louis is fond of saying, “Only Lhe lunatic fringe 
will lead us to the truly innovative applications." Every machine 
is programmable right out of the box, and comes bundled with 
programming tools from Metrowerks anti bill developer 
documentation. We do not expect that die BeBox will be your 
first computer - it will not run any Macintosh software nor will 
it run Windows* However, if you are excited by new 
technology, know how to write code, and have a pioneering 
spirit, die BeBox may have something to offer you. See Figure 
1 for a screenshot showing a few running Re applications. 
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Peter Potrebic and Steve Horowitz- When not our riding one of his bicycles up a really big hill, Peter Potrebic is a happy 
software engineer at Be lne. He's worked at Be for the past year and a half, Before coming to Be, Peter sjient eight years at 
Apple Computer engineering software for Newton, NTK, and MPW, Steve Horowitz is a software engineer at tie Inc. When, 
not giving demos at Be he can generally he found chasing pucks around ice links or watching others do the same. Having 
worked at Be for four years, Steve has finally given up hope of being called up by the Sharks. Prior to Be, Steve worked at 
Apple Computer for two years as an engineer and four summers as an intern. 
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History has shown that it is difficult to predict the markets 
where a new computer might be successful We believe that 
developers will lead us, and so our goal is to provide a unique 
set of system software features, a low-cast hardware platform, 
great development tools, and an extensive developer support 
program. Additionally, we plan to help our developers reach 
their potential customers by offering electronic distribution of 
their software on the Be web site. From all of tills we hope to 
see new and innovative applications for markets we could not 
possibly envision. 

The Befiox was designed by an extremely small team over 
approximately four years. We started with a dean slate and 
focused on a couple of key ideas. One of Lhe fundamental 
design techniques was to give responsibility for each major 
system component to one person. By concentrating the 
decision-making process, the engineers were allowed a great 
deal of freedom without having to justify and get consensus for 
every design decision. However, since most of the components 
were interrelated there was enough informal interaction to 
assure that we were all on the same track. This approach 
allowed us to avoid some of the pitfalls of overdesign and 
resulted in what we believe is a simple, efficient, and fast set of 
system software components. 

Another decision we made early on was to take a C++ 
light approach. We wanted to use an object-oriented 
programming language, but not necessarily to use every feature 
the language had to offer. Programmers need not be C++ 
experts to program the BeBox. This decision makes the system 
more approachable by a larger number of people with a variety 
of programming experiences. It is also fairly easy to absorb die 
Be class libraries and get a simple Be application up and 
mnniog quickly. 

System Software Overview 

The design of the Be operating system is based around a 
client/server architecture, with a microkernel aL the lowest level 
providing all the OS functionality used by the higher levels. 
The developer makes use of a set of client-side C++ class 
libraries and C functions to write Be applications. 

The system software consists of a number of key 
components. Several servers are built on top of the kernel 
including an application server, storage server, network server, 
and media server. The servers run in separate protected 
memory areas and implement the majority of system 
functionality available from the C++ class libraries. The class 
libraries are broken up into a series of kits which export the 
functionality from the servers to the client applications. Among 
Lhe kits available to Be applications are an application kit, 
interface kit. OS kit, device kit, media kit, midi kit, networking 
kit, and storage kit. The details of all of these kits are beyond 
Lhe scope of this article. Instead, this article provides a brief 
summary of each server's basic functionality, followed by a 
description of the major pieces in a simple Be application. 

The Be kernel provides many fundamental system services 


to the higher-level servers including the ability to deal with 
multiple processors, true preemptive multitasking and 
multithreading, memory protection, shared memory, 
semaphores, virtual memory, shared libraries, and loadable 
drivers. The kernel scheduler supports multiple processors in a 
manner completely transparent to the application. This and 
other features of the kernel provide an extremely fasL and 
efficient foundation upon which the rest of the operating 
system is built. 

The application server is Lhe main server with which 
applications communicate. It is in charge of all the window 
and view management, graphics rendering, font management, 
user interface interaction, event handling, and so on. One 
important aspect of the Be programming model implemented 
by the application server and interface kit is that every window 
in Lhe Be system is given two separate threads. The application 
server maintains a thread on the server side, which 
communicates with a client-side thread running in the 
application's address space. This allows all w indows to update 
their contents and respond to user interaction asynchronously, 
and is a major factor in the overall responsiveness of the Be 
system, This also means that any multiwindowed Be 
application is automatically multithreaded and multiprocessing 
with little work from the developer. You can, of course, spawn 
more threads for your application using other classes in the 
application framework or the lower-level kernel functions. 

Another important server is the storage server. It 
implements the built-in database functionality in the Be 
operating system. The storage server allows programmers to 
design tables dial describe records, create and delete records, 
and receive notification of database changes. With the 
integrated database, every file on the BeBox has its own 
database record. This acts as an extensible storage system, 
allowing programmers to create unique tables containing 
whatever information they want about a file. The fields in 
these records (as defined by the table) are then searchable and 
viewable by all applications in the system. Additionally, the 
storage server implements a live” query mechanism that allows 
any Be application to construct a query and then, if desired, get 
notified continuously of any changes to the set of records 
located by the query, This behavior is seen in the system 
Browser (an application akin to the Macintosh Finder) which is 
part of the operating system, but this service is available to all 
Be applications. 

The network server provides basic system networking 
services. It implements the TCP/IP protocol stack and provides 
a socket interface resembling Berkeley sockets. There is also a 
PPP layer included in the server, and support for Ethernet. 
Standard networking tools such as ftp, ftpd, and telnet are 
included with the Be system. 

The media server provides a set of tools for manipulating 
large streams of multimedia data. This server handles the 
transportation of buffers of media data through a pipeline of 
interested data handlers. Each handler can subscribe to a 
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media stream, Ry subscribing, the handler is given a chance to 
manipulate or read the data as it passes through the system. 
The buffers are implemented ns shared memory areas, which 
can be read by multiple applications in separate address spaces 
without having to copy the buffers between applications. 
Additionally, you can use the media server to synchronize 
separate media streams, using a global scheduling object that 
allows easy coordination of audio and video data, 

Bl Application Basics 

A simple Be application will primarily make use of the features 
in the application kit and the interface kit. The core objects 
used by an application are BAppl ication, BWindow, 
BView, BMessage, and BLaopcr. BLoopcr (feel free to call 
it “blooper’ 1 ) is the main object used to encapsulate thread 
spawning and message handling. Bach BLooper object has its 
own thread that responds Us messages sent to it by other 
objects. Since BApplication and BWindow both inherit 
from BLooper they are automatically message handlers 
running in their own threads. 

Generally, a BApplication object is created first, It runs 
an event loop in the main thread of the application, and is used 
for basic messaging between applications. It can also be used 
to exchange messages with windows or other threads in your 


application. Additionally, the BAppl ication object receives 
notification of files to open at launch Lime or once the 
application is running. The BApplication object is the 
central control object from which other windows and objects 
are created and can be used to synchronize sharing of global 
objects within an application. 

Most of the communication between threads, windows, 
and applications in the Be system is done using a BMeasage 
object. A BMessage has the ability to contain an arbitrary 
number of “data” entries to pass information around, as well as 
a “what” held to tell the receiver what type of message it is 
receiving, BMessagos are the fundamental objects used to 
share information between threads and applications. They arc 
also used to implement drag-and-drop and the clipboard. 

To actually display anything in your application, you must 
create a BWindow object and add a BView to it. Each window 
you create, by virtue of its B Loo per inheritance, will spawn a 
new thread to handle drawing, messaging, and user interaction 
- without monopolizing your application’s main thread, 
Windows are also the containers of RV i ew objects, and handle 
the display of any drawing that takes place in a view. A 
BWindow cart contain multiple views and, in turn, views can 
contain other views. Each view has its own drawing 
environment and all drawing is automatically clipped to the 
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hounds of the view. When a window needs updating, it calls 
the virtual DravO function for all the views in the update 
region. Within Draw() other functions are used to render 
graphics primitives, such as bitmaps, lines, shapes, and strings. 
Most of the user interface components in the Re system such as 
buttons, scrollbars, menus, and others are derived from BVIew, 
and handle drawing and mouse events automatically. 

There are many more classes in the Be application 
framework available to developers. The ones described above 
are simply the most fundamental to a Be application. They 
provide the basic' functionality for an application that wants to 
launch and put up a window to do some drawing. Since the 
entire Be operating system Is relatively small, it is easy for one 
person to understand it all. Ii is also easy to learn and to get 
an application up and running quickly in the Re environment. 

Tin; Bouncing Bail 

Now let's cut u> die chase and explore a sample application. It 
seems that every new computer platform comes with a 
bouncing-ball demo. Each platform uses this application to 
show something particular or unique about itself. The 
boundng-bali deino on the BeBox, called BeBounce, builds on 
this tradition - and add adds a unique twist. 

The BeBounce application opens a small window that 
contains a single bouncing ball. The twist is that launching a 


second instance of the application opens a "gap” between the 
windows, the size and location being determined by their 
relative positions, and the ball is then able to bounce between 
the two “partner" applications. As cither window is moved 
around the screen, the gap between the windows follows die 
motion, growing larger or smaller and moving around each 
window frame as dictated by Euclid (i.e. by geometry). See 
Figure 2, If the hull happens to enter the gap it is magically 
teleported to the other application. 



Figure 2. The BeBounce application 

In addition to showing some basic Interface Kit techniques, 
the BeBounce application demonstrates the straightforward way 
in which applications can communicate. As explained earlier, 
each Be application runs in its own address space and each 
window runs in a separate thread. Additionally, each 
application lias a “main thread" represented by a 
BApplication object. The multithreaded nature of an 
application is inherited from the BLooper class. BLooper 
objects execute a message handling loop which responds to 
messages posted to the loo per using its PostMessage 
function. The looper then dispatches those messages, in 
sequence, to ihe “target" BRecelver object by calling the 
virtual MessageReceived function. Note dull BLooper is a 
kind of BReceiver so a kxiper can also receive messages. 

The BeBounce application consists mainly of one object 
derived from BApplication (TBounceApp), one object 
derived from BWindow (TWindow), one BMessenger object, 
and one object derived direedy from BLooper (TBal 1). In 
the Be system, BMessage objects can be, sent around within 
an application. However, to send messages between 
applications a BMessenger object is needed. The messenger 
object is a one-way connection between two applications. In 
BeBounce, when the ball enters the gap a message is sent to 
tile partner using the messenger object, literally passing the 
ball to the partner 
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MACINTOSH SOFTWARE DEVELOPMENT 


Let’s Like a look at .some code, starting with the mainO 
function: 

wain tint argCt char* argvll) 

I 

// m randomize ihc movement of the bouncfog ball 

grand £ £ long) syfi Jtisae () ) ; 

ff make ihc new application object and start it running 

my_app - nev TfkmnceAppO: 
my app‘>Run(J; 

// application h finished so ckanup and return 
delete myapp: 
return 0: 


The hasie idea is to create the application object and start 
it running. The RunO function returns when Lite application 
quits. The TBounceApp object is then deleted and the 
program returns. Most applications on the BeBox will have a 
similarmaI n {) function. 

The application object 

The BApplication object is the real launching point for 
most applications! and BeBounee is no exception. Here is the 
definition of the TBounceApp class: 


class TBounceApp : 
public: 

public BApplication 1 

TBounceApp(); 

virtual 

-TBounceApp U; 

virtual void 

KessageReceivediBHessagc 'Bing); 

void 

TnitPartnet-(rhread_id cid): 

void 

Remove Pa rtnerO; 

bool 

SondToPartner(BWessage *msg); 

bool 

Send Posi 1 1on(B Rect rect); 

private; 

TVindow 

•fWindow: 

BMcssenger 

*f Partner: 


h 


The application constructor does several interesting tilings. 
First, when Lhe application is launched it needs to determine 
how r many instances of the BeBouncc application are already 
running* Here is a portion of that function: 

TRmmceApp:: TBounceApp () 

: BApplication (&¥_*?! GNATU RE1 

I 

// some initial ration u*k 


t 

1his version of BcRounce only supports l instances of the application running at 
the stme time. So if then: arc already 2 instances running force a QUIT, 7 

BList list: 

be_rQ£te£”>GetTh read List (KY._ SIGNATURE* Mist): 
lung rtpp_r,©imt * list.Count I terns 0: 

if Tupp_count > 2 ) I 

ff only support 2 applications at a time 

Poe tMe s s a ge ( QU 1 T_REQ NESTED): 
return: 

\ 


.. . ff more initialization to lie discussed lx low 

1 


The above code uses lhe be^roster (aka “rooster”) 
object, a system-wide object that, among other things, 
maintains information on all running applications. The roster 
returns a list of all running applications that have the signature 
MY_SIGMTURE. If there are more than two instances of the 
application already running, this instance simply quits* 

If this is the first instance of the application il simply 
creates the window: 

if Capp_count ° 1) I 

//Tbe first instance of lklkmnce will have a hall 

fWindov - no* TWindowfwpos f "Bouncing t*\ TRUE): 

I else I 

...ff the second instance of BcBouncc 

I 


If tliere are two instances, things are trickier: 

if fapp_count =1) I 

... // the first instance of IfctkHimc 

1 else \ 

// Thb is rhr second instance tl>c ESdSnuncc app 

fUlnrfov ~ new ItO ndowfirpas. "Bouncing 2", FALSE); 

ff determine w hich of the 2 instances is myself and wtik. li is the partner 

/f iid K the 'thread id' of nor partner* 

InitPartnerftid); 
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Software 


r ^ral tile mtAKliKtory meswj^ with my ihrvad 
id 4iid hicaiioii in ?*ti*rti coordinates, 7 

BHessag* *»m * new Btfossage EBB_SELL0) i 
ns& >AddCongT*ihroud" . Thread (}) ; 

«£g >AddHeet("rect". vpos); 
ScndToFartner(ttsg): 


Here, as before, the application creates the window. It 
then determines the thread id of its panoer application and 
initializes a RMessenger objea for communicating with the 
partner. The code that creates the messenger is in the utility 
member function TBounccApp: :InitPartner(): 

void TBouiu/oApp::initPartner(thread id tid) 

i f (f Pa rtner) // till HELLO race condition 
return; 

// establish a ‘messenger * 1 4s ihc link in our partner 

fPartrmr - new HMessiouguf(HTf_SlC t tid); 

If ((Partner >Error() != N0_EIUi08) I 
delete fFanner: 

(Partner - NOLI: 

I 

I 

Ti is important to note that this function handles the race 
condition surrounding the BB_HELLO message. Imagine 
launching two instances of Beliounce at the same time. 'Hie 
call to GetThreadLisl () could return two instances to each 


application. In this case both applications will behave as the 
second instance and both will send BB^HELLO messages, This 
vs iU res li 11 in TBcmncp.App: ;Tni t Pa rtner being called twice 
by each application. In this particular application the only 
result would be a small memory leak of the first BMessenger 
object. Understanding these types of race conditions is one of 
the critical aspects of designing software for the BeBox. Note 
that the code does not handle three applications launching 
simultaneously. In this case all thrce applications might decide 
that they are the "third wheel* and quit. 

After creating the messenger, the code constructs a 
BB_IIELLO ^Message object. The next step is lo add the 
thread id of this application to the message. The other 
application uses this data to construct its own RMessenger, 
The window position is also added to the message so that the 
partner knows this window's initial position. Hie message Is 
sent using the utility function TRounceApp:: 
SendToParlner. Other than error handling 
SendToPartner contains just one line: 

bool Tlk>\mceA|jpr :Ser.dToFa£tner(BMessage 

// enur handling 

fPartner ^SendKesssgetnsg): 

... //effur tuuHllioK 
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The final steps of the constructor are to create a “Slop Ball' 
menu item and show the window on screen: 

// inside the TBounccApp constructor 

r 

A little bit of menu code Add * Stop Halt menu item to the application menu 
(found in the Dock window) By default items in the 4 app' menu post mes^o to 
the ippliLitioii In this case the message should be 'targeted 4 to the window, not 
the app. 

7 

BPopUpMenu 'menu - AppMentiO; 

BMenuItetn 'item " new BHenuItem("Stop Ball 11 , 

new KMeoflage(BB_STOP), 'K'); 
item- >SetTarget (fWlndow); 
menu->AddItem(item): 

fWindovt-> Show{); 

// this is the end of the TBounccApp constructor 


The protocol that the applications use to communicate 
with each other is most apparent in the TBounceApp; ; 
MessageReceived () member function: 

void TBounctApp : sMessageReceived EBWessage *msg) 

1 

switch (tHSg->vhatJ I 
case BB_ HELLO: 

, // a wcimd Ik Bounce application is saying hdk)T 

break: 

case BBJSOO0BYE: 

// our partner is quitting 

break; 

case BBJrtNDOWJtOVED: 

... // partner moved, and has given us its new position 

break; 

ease 8B_BALL: 

, . // we've Just been given the ball 

break: 

I 

I 


Receiving a BB_HELLO message means that a second 
instance of the application is introducing itself. Here is the 
code for handling this message: 

ease BB.HELLO: 

If (ftfindov-)Lock(J) I 

r 

A new instance of Be Bounce was just launched 
ami sent us the introductory message. 

7 

InitPartnerImsg >FindLong("thread")): 

// Initialize our partner's current location, 
poe ■ tneg->FindRect ("rect*); 
fWlndnw >PartnerMoved(pos); 

//Tell our new partner our current location. 

pqu * fWindow >Framed ; 

SendPositionCpus): 
fWindev">tfnlock( ); 

J 

break; 


This code initializes a BMess eager using 
TBounceApp: : InitPartnerC) and places the thread id in 
the message* The partner’s window position Is also retrieved 
from the message and saved. Finally the code determines the 
position of its window and sends that to the partner. The 
communication link between the two applications is now open. 


The next message is BB_GOODBYE. This message is sent 
as BeBounee applications quit. The code for responding to this 
message is quite simple: 

ease BB_GOGDBYE: 

if (fWiadovOLockO) ( 

// Our partner is quitting 
ReraovePartnarO : 
if (msgOHasBooirball")) 
fWiudow->AddBan(): 
fWindow->Unlock(); 

\ 

break; 


The partner Is removed using the function 
TBounceApp :: RemovePartner, the complement of the 
InitPartner function seen earlier. In addition, if the quitting 
partner currently had the ball a new ball is added to this 
application's window. This ensures that there is always a 
bouncing ball. The code that sends the 8B_G00DBYE message 
is described in the section on the window. 

The final two messages sent between the applications. 
BB_WINDOW_MOVED and BB.BALL, are status messages 
informing the partner that either the window moved or the ball 
has moved through the gap. Here is the code, without further 
explanation: 

case BB„WIND0W_M0VED; 

r 

Our partner is informing us that it moved, This message is continually 

generated as the cither window i.s Being moved. Window;;TWmerMoved 

redraws the window to reflect the new position. 

7 

if If Window >LockO) l 

pos = rasg->PiadHect ("met*): 

FWindoV'^PartnerMoved(pus); 
fUindow->UnlockO ; 

1 

break; 

case BB_BALL: 

// Our partner jusi passed us the ball 

if (fWindoW’ >LockO) t 

BPoiut speed ” osg >FindPoittt(^ speed"); 
float rel_loc - aag->FindFloat("rel_loe"); 

(Window->AddBall(re1„loc * speed): 

FWindow-MlnlockO; 

\ 

break: 


The window object 

The next class of interest i.s TWindnw, a subclass of 
BWindow. In the BeBounee application the window is 
responsible for managing the ball and for informing the partner 
application of particular events (see description of 
TBounceApp: rHessageReceived () alxive). The window 
also presents the UI for this application so there is some 
description of how applications can create anti manage UI on 
the Be Box In the Be operating system a BWindow object 
provides an area that on display and retain rendered images. 
A BWindow by itself cannot draw, only BViews can draw. 
However, a BView must belong to a window in order to draw. 
These two classes work hand in hand. 

Here is a portion of the TWindow class definition: 


34 


Ol-NING THF BeBOX 


Ma<3'koiMagazinf: * January 1996 











IfcdtF 


When it comes to performance dtF is in a 
class all its own. dtF utilizes a proprietary 
query optimization and caching scheme to 
obtain unparalleled performance. If you are 
in need of a quantum leap in performance, 
use the dtF native PowerPC stand-alone or 
client/server version. 


Full transaction control and automatic level-3 error 
recovery guarantee maximum data protection even after 
sudden system crashes, dtF databases are compressed and 
encrypted to protect against ail unauthorized access, even 
disk editors. Implement sophisticated table and operation 
level security with dtF s password features. 


The Relational 
Database System 



Stand-alone 
applications built with 
dtF are royalty-free! 


...data security 


With dtF s unique direct integration technology, the dtF database system 
is fully contained in your application, enabling you to build double- 
clickable database applications. Never worry about missing or conflicting 
INITs or drivers. dtF's native API is compact, easy-to-use and integrates 
seamlessly with all major development environments on the Macintosh, 
dtF's high performance SQL. integrated data dictionary, security 
features, automatic index selection, query opt i mi/a l ion and error 
recovery allow you to concentrate on creating great database applications 
instead of messing around with the internals of the database system. 


dtF is available for Macintosh System 7.x (68K and native PowerPC). 
dtF supports MPW C/C++, Symantec C/C++. Metrowerks Code Warrior 
(all compilers 68K und native PPC). dtF is fully OpenDoc™ compatible. 
Separate versions for use with HyperCard 2.x, SuperCnrd 2.x, Smulltalk- 
A gents and Pictorius Peregrine are provided. AppleScript interface via 
DataScripl™ for dtF from General Knowledge. dtF supports cross- 
platform development on Windows 3.11, Window's 95 and OS/2. 


dtF Americas, Inc, 

19672 Stevens Creek Rlvd., 
Suite 128 

Cupertino, CA 95014 
USA 


Phone: (800) DTF-1790 

Fax: (510)828-8755 

AppleLink: DTF. AM ERICA 
Internet: dtF.amcrica# 

appldink.apple.com 


gj&T'y J iT? The Relational 
Wm LI IT Database System 














r^% rpi TM 

PowerTap 


Q: How do you make a Mac run your software 
10-20 times faster than it does now? 

A: Let it tap into a faster Mac! 

If you don't believe it, send for a free test report. 
Better yet, try our demo yourself. You won't believe 
how easy it is either! 

* Easy-to-use API • Supports PowerPC, 6BK, 

■ Robust A4 and Thread Manager 

• Compatible software. 

* Supports uni- and 
multi-processor machines. 

Emerson Kennedy 

'yy 

PO Box 2530 * Redmond WA 98073 


close TWindow t public BWindow I 
public: 

TVlndovlBRecr Frame, const char ‘title, 
bool with ball}; 


virtual 


-TVfindovO; 

virtual 

void 

Men s a geRec civ ed(BMc s sa ge 1 ms g) : 

virtual 

boot 

£)u It Requested() : 

virtual 

void 

FrameMoved (BPoiiit new position); 


void 

Add Bali 0; 


void 

AddBalKfloat reI_location* BPoint speed); 


// a few more member functions 


private: 

void DrawOffSfereen(RVicw *v); 

// p couple more private member functions and then 
fj some private data members 


The TWindow constructor contains several code fragmen is 
worth discussing: 

TWindow::TWindow(BRect Frame, const char ‘title, bool ball) 

: BWindow£frame, title, TITLED WINDOW, NOT RES TZAR? JR) 

I 

... // some initiaJbatkm removed 

If (ball) 

AddBailO; 

r 

The drawing lakes place in the view' fOfTVjew that was added to the offtcreen 
bitmap fBitmap. In this way we ll do the drawing offscreen and then just blit the 
result to the screen, 

7 


fBitmap - new BBitaap(b, COLOR 0 BIT, TRUE): 

FOffViev = new BViev(b, **. 0, WUX, DRAW); 

fBitmap->Lock(); 

fBitmap >AddChild(FOFfView): 

i)i awOf f Screen (f Off View); //draw the imilal corncob offcereen 
fBitmap >Unlock(): 

f 

Iliis view is added tti tile visible window. Its only role is to blit the offscreen 
bitmap to the visible window 

V 

fMairtView - new TBItmepView(b, fBitmap); 

Add Cliild (FMainView) ; 

... // some initialization removed 

1 

Here is the first look at how windows and views are 
created and used on the Be Box. To get smooth animation 
TWindow uses an offscreen bitmap (a BBitmap object) and a 
basic flView object (f Off View) for the rendering. It is in the 
context of this view that alt the actual drawing occurs. The 
graphics primitives, like BView: :FillRect () and 
BView:; Fill Arc 0 that create the effect of a ball Ixaincing 
off real walls, lakes place in this offscreen view. The last view 
created, an instance of the TEitraapView class, is simply the 
helper view that blits the bits from the offscreen bitmap into 
ibe onscreen window. Since the TBitmapView class (a 
subclass of BView) is so simple here is all its code: 

TEf rnapVIow: :TR1 r mapView(RRcc-L fruae. BBitmap ‘bitmap) 

: BView (frame* w, \ t k OLLOW_NQNti, W1LL_DRAW) 

I 

r 

The only [ob of this view is to blit the offscreen bits into the onscreen view, 

7 

fBitmap = bitmap; 


void TBiunapView::Brav£BRect update) 

t 

// blit tire bitmap with source and dcst rectangle update' 

DrawBitmapEfBitmap, update* update); 

J 

As stated previously, a BWindow is a kind of BLooper, 
which in turn is a kind of BReceiver. As such, a window 
runs in its own message loop and it can receive messages. A 
BView is also a kind of BReceiver so it too can receive 
messages* A message posted to a window (using 
PostMess&ge) can be “targeted" to either the window or a 
view contained within that window, Because of the connection 
between windows and views, a view typically receives 
messages in the context of its window, Sait! another way, the 
handling of messages targeted to a view occurs in the window's 
thread. 

On the Be Box, user actions on the keyboard and mouse 
are turned into BMe usages, called interface events. However, 
these messages are not handled by MessageReceived (), 
like the BeRounce message BB_HETX0, Instead, interface 
events are dispatched to a set of virtual functions 
corresponding to tile action. I tere are a few of those functions: 

BView;: Mb use Down [) // mouse down event in that view 

BView ;: KayDown () // kcydnwn event while that vkw was 


(800) 297-3888 

powertap aol.com 
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Gives you the Information to Program your Best ! 


The Debugger V2 
& MacNosy 

By Steve Jasii^ 



Information 




Control 


T he Debugger is a low and high-level symbolic 
Debugger that runs in a full multi-window 
Macintosh environment. You can trace program exe 
eulion* view the values of variables, etc. of both 6SK and 
PowerPC programs 

Mac Nosy is a global interactive disassembler that 
enables one to recover the source code of any Mac applica¬ 
tion, resource file or the ROM. 

When you compare features of the different debuggers* 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program in a full system (6.Ox or System 7.x) environ¬ 
ment symbolically! 

It is the only debugger to use the MMU to protect your 
COOK resources and the rest of the system from the pro¬ 
gram you are debugging* With MMU Protection you can find 
errors when they happen, not millions of instructions later! 
(Macintoshs with 68030 CPUs only). 

The Debugger is the debugger of choice at: Adobe* 
Aldus, Claris, Electronic Arts. Kodak, Mclrowerks, etc. 
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An example of a structured data display window 


Its Features Include: 

• Symbolic Debugging of any Macintosh program. ROM* or 
code resource (DKVRs. XCMDs, INITs, PDEFs, 4DEXs 

m Source level debugging for Metrowerks & MPW compiled 
programs [C++, C, Pascal* Fortran. and an Incremental 
Build System with instant Link for superfast development. 

• Object Inspector for MacApp 3 programs 

• Source level debugging of Think C™ projects 

• Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc* 

• Simultaneous Symbolic debugging of multiple “tasks" 

• Fast Software Watchpoint command to find clobbered 
variables 

• Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking)* Handle Zapping, Heap 
Scramble and Heap Check to detect program errors before 
they become disasters 

• Structured display of data (hypertext) with user definable 
structures while debugging 

• Conditional breakpoints to help filter out redundant 
information 

• Continuous Animated Step Mode to watch your program 
execute instruction by instruction 

• Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps, - 
make it possible to ferret out the secrets of the ROM* etc. 

• 'Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 

The Debugger V2 & MacNosy: $350 

Runs on all Macs. Call For Group prices or Updates. 
Visa/MC Accepted. 

Available from: Jasik, APDA* Frameworks or 
ComputerWare (800-326-0092), 


Jasik Designs • 343 Trenton Way, Menlo Park, California 94025 * (4 1 5) 322-1386 

Internet: macnosy©jasik,com • Applelink: D1037 






















You Can't Wait Forever. 


Let's Face It 

As a professional developer or webmaster, 
you have to think of yourself first. You have 
deadlines to meet, products to deliver, and 
people depending on you. 

A Tool in Hand... 

Your tools are your livelihood. You need up- 
to-date technologies and timely support. You 
can't afford to wait for vaporware to material¬ 
ize or for your tools vendor to leisurely add 
features that you need today. 

When Hell Freezes Over? 

When was your text editor last updated? Six 
months? A year? Five years? And when you 
contact the vendor that produced it, do they 
tell you how they're working on the next great 
version, how wonderful it's going to be, and 
how it will ship "Real Soon Mow"? Or worse 
yet, do you get a disconnected phone number? 

That's where we come in. 

At Bare Bones Software, we deliver the best 
tools here and now. We have a distinguished 
tradition of continually enhancing the function¬ 
ality, performance, and design of our products 
to meet our customers' needs. We don't allow 
our products to languish until we feel like doing 
something about it We won't hype vaporware 
as the solution to today's problems. And we 
haven't drifted in and out business on a whim. 
We're here to support you foT the long haul. 


What About the Software? 

You don't have to wait for the software, either. 
We're constantly refining our techniques and 
technology to bring you the fastest and most 
efficient tools. As the result of our efforts, 

BBEdit has repeatedly raised the standard for 
Macintosh text editing. (In fact we've done so 
many cool things, several of our competitors 
have tried to copy us. Imitation is the sinccrest 
form of flattery, after all. We're very flattered.) 

Why Believe Us? 

Since its commercial debut in 1993, BBEdit has 
set the pace for capability, user-interface, 
functionality, and customer support that others 
have yet to match. BBEdit was the first text 
editor to support ToolServcr, THINK Reference, 
Toolbox Assistant, THINK C/Symantec C++, 
Internet Config, Quickdraw GX printing, 
PowerTaik, PowerPC acceleration, AppleScript, 
Apple Guide, and Macintosh Drag and Drop. 
We're still setting the pace for others to follow, 
as the only Macintosh text editor to integrate 
directly with Metroworks CodeWarrior, through 
the use of the Click Warrior extension. 

See for Yourself. 

We've painted a groat picture, but don't take 
our word for it. Visit our Web site and see for 
yourself. You'll find lots of things to like. 

BBEdit. Because you 
can't wait forever. 
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Clean Up Your Act. 


Introducing SoftPolish. 

SoftPolish is a quality assurance tool that 
helps you deliver applications that are clean, 
consistent, and free from spelling and user- 
interface mistakes. 

End Embarrassing Odor and Wetness. 

Apply SoftPolish to your product's resource 
file (or built application). SoftPolish checks file 
integrity, scans the application signature, menu 
and 'cmmT resources, controls, dialog items, 
pictures, strings, "TEXT' resources, windows, 
and Balloon Help" 1 resources. It reports any 
structural, spelling or typographical errors that 
it encounters. SoftPolish also checks the layout 
of dialogs and controls to make sure that items 
don't overlap. At your request, SoftPolish will 
also correct spelling mistakes, so you'll never 
again ship a product with embarrassing typos. 


Put on a Pretty Face. 

When preparing your product for release, 
use SoftPolish to ensure a perfect presentation 
to the world: it cleans up unwanted resources 
in your files (such as extraneous 'SIZE' and 
'ckid' resources), sets creation and modification 
dates to a consistent value, and checks the 
spelling of file and folder names. After all, your 
customers don't really need to know that the 
product was built at 4:30 AM on the day after 
you announced... Do they? 

A Software Mine Sweeper. 

When applied to a 68K application, SoftPolish 
also catches code that you wouldn't want your 
customers to see: Debugger and Debugs tr 
calls, CHK and TRAPV exceptions, and Macsbug 
symbol names. 


SoftPolish. The Essential Tool for Software Quality. 

Visit our Web site or con Lac t us for more information about SoftPolish and our other fine products. 


Something for nothing. Although our commercial products have won critical acclaim and popular 
support worldwide, we've also built a reputation for producing free software that exceeds the quality 
standards of many commercial products. 


BBEdit Lite The freeware cousin to our 
award-winning text editor. Used and loved 
by countless people worldwide. 

Drop'FS Sends PostScript 1 * or EPS files to 
any network-connected PostScript printer. 


PopupFtincs Adds sourcc-code navigation abilities 
to any PopupFuncs-a ware text editor or integrated 
programming environment (including MPW, 
Symantec C++ and Mctrowcrks CodcWarrior). 
Enables you to browse C, C++, Pascal, 68K 
Assembler, Rez, and FORTRAN source files. 



Bare Bones 


Bare Bones Software, Inc. 
P.O. Box 1048 
Bedford, MA 01730-1048 
USA 

Voice: (508) 651-3561 
Fax: (508) 651-7584 


E-mail: bbsw@netcom.com 

Web: http://www.tiac.net/biz/bbsw/ 

FTP; ftp://ftp.std .com / vendors/bbsw / 

ftp://ftp.netcom.com/pub/bb/bbsw/ 

Our goodies can also be found at many popular sites, 
including the file libraries of AOL, CIS and eWorld. 


Our lawyers insist we say: BBEdit, BBEdit Lite, PopupFuncs, SoftPolish, Drop* PS and ourspiffy logo are trademark* of Bare Bone* Software, Inc. Mac and the MacOS logo 
are trademarks of Apple Computer, Inc., used under license. PowerPC is a trademark of International Business Machines Corporation, All other trademarks and registered 
trademarks are properhes of their respective holders. Bare Bones Software, Inc. products am cruelty free (except for a few beta testers), tfo J Bare Bones Software. Inc. 
















PO SITIONS WANTED - 

Available Immediately 1-800-736-} 5 77 

Expert 4D Programmers 
Less than 500 per hour! 

Merc chan 1,000 hour, of development wem into 
4 D Toolkit 2 . 0 . With a one time price of S 300 ■ 
SS hirin, a crack team 
less than 50 * per hour. Call 1 - 800 -■ * - 

order your copy, or to receive a tree demo.- 


4 d t o o l k i 


Options Computer Consulting 
228 BJcetkcr Street H19 
New York, NY 10014 
im: 212-645-3177 

FAX: 212-633-0336 
* upgrvdt paring atmiUbk 


// the "focused* view 

BView:;Fra mv R v siztul // the view changedstiat 

HWinflow; :FraraeHoved () // the window positionmoved 

BWindov: :Qui ^Requested < // dick on dose-box of window 


It turns out that in BeBounce only two interface events are 
of interest, the FrameMoved and QuitRequested events. 
The system rqx. 4 atedly generates the FrameMoved event as a 
window is being dragged. This event is of interest because us 
the window moves, so should the gap that exists between the 
partner windows. Here is the code for responding to the 
FrameMoved event: 

void TWimtew;iFraseHovedfBFoint new pos) 

[ 

r 

As window' is moved around the screen we inform our 
partner of our new location. Also update our gap. 

7 

My Frame " Frame{): 
i t t ay_a p p - > $ e nd P os i z ion{f Hy F r ame}) 

WindovsHoved(fHyFraite* FPartnerFrame); 

I 


This code gets the window’s current location and sends it 
to our partner so that our partner can update its gap. 
TBounceApp::SendPosition() sends the BB_WIN DOVXMV10VKD 
message to the partner (see the code in 
TBounceApp: : Mes sageReceived () for the code that 
handles this message). Only if we have a partner will 


TBounceApp:: SendPos i t ion () return TRUE. In this case 
the code calls the TWindow: :WindowsMoved () function, 
updating this window’s gap. As lie Bounce windows move 
about the screen everything is kept in synch. 

The other event of interest is generated when the user clicks 
on the close box of the window. In BeBounce closing the 
window should also cause the application to quit. This means 
Ll tat d ie w indovv i ms It > l isle n ft >r til e Q i j i t K n qi i e s t e d eve nr: 

bool TW3ndow:-QuitRequentndH 

t 

f 

The window was asked to quil/ckxsc. Send a message to our partner, giving him 
the lull if we've currently gin k 

7 

BHessage *m = nsw BMensagetBB GOODBYE); 
if (fBall) I 
FBal1 0; 

FBall - HULL; 
n >Add Bool t* ball 1 *. TRUK); 

I 

my_app->SendToPamier (n): 

// TdJ Lbc app to go ahead and quit. 

my a pp - > Pos tMes s a ge f (5111T R EQNESTED): 
return TirtK; 


The first thing to do when the QUTT_REQUESTED message 
is received is to tell our partner g<xxl-hye, passing the ball 
along if it is in our possession. It would not lx.* polite to quit 
with ball in hand. Please note that the TBounceApp:: 
SendToPartner () does the correct thing if there is no 
partner. Next the window posts a message to the application 
telling it to quit as well. The return value of TRUE causes to 
window to immediately quit. 


The hall 

The fast object to describe is the ball, Several factors 
influenced Lhe design of the hall. It is desirable to keep ihe 
ball independent from the window, yet they still need to 
communicate with each other. Also, the ball periodically 
requires time to simulate motion. One design that 
accommodates these guidelines is to construct a subclass of 
BLooper called TBal 1. This means that the ball has its own 
thread and it is able to receive messages. Here is parr of the 
class definition: 


class TBall : public Blooper I 

public; 

TBa 11 (TW1 ur] ov 4 window, RRoe l bound %, 
BPaint center, float radius. 
BFoint speed): 


void 

virtual void 


DrawtBViev 4 viev); 

Messa^eRecelved(BHessage * msg); 


void Lock(): 

void Unlock!): 

void SelGaptrioot start, tloat end); 

void SetEnabled(bool state): 

// a couple mher mcmlxT (unciions 


private: 

void NextPosition(bool “hit, float ‘angle): 

void Tick Of 
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FREE INSTALLER! 


To: Ma< Developers & Product Managers 

From: MindVision (Co-authors of Speed Doubler) 

Subject: Free Copy of DEVELOPER VISE 

Message: We've got a great new installer for you. 
Here's your chance to try it for free. 

Ho risk, no obligation, no hassle. 

Call today, don't delay! 



www.mindvision.<om 



Join the: growing list of companies who use our VISE technology: Adobe, America Online, Apple, Claris, 
CompuServe, Connectix, intuii, MacroMedia, Netscape, Symantec, WordPerfect, and hundreds others. 


MindVision m 
Software W 


€> (992-% Mjek] vision Software. All Developer VISE Ls- a tnttkmark of MimlVbuon Software. 


MindVision Software 840 South 30th St f Suite C, Lincoln, Nebraska 68510 
Voice; (402) 477-3269 Fax; (402) 477-1395 Internet: sa]es@mindvi,sioitt:om 
AppleLink, AOI.: MindVision * CompuServe: 70253,1437 










































































E-Locks r fLock: 

TWlndow 'fWi miow: 

,.. //1 hunch of data members for “stale 1 ’ like size, 
// spccd/direction, postion, etc 


Having a thread per ball would not scale to an application 
i hat had 1000 bouncing balls, but for demonstration purposes it 
works well 

Most of the constructor for the TBall class is fairly simple, 
initializing the various data members. The most interesting 
aspect of the constructor is that it starts the looper thread 
running and posts the first BB TICK message to gel the 
animation working: 

TBall:: TBall(TWindow 'window, BReet bounds, BPoint center, 
float radius* BPoint speed) 

; flock0 

l 

... ff initialize parameters like slocation, and speed 

r 

Get the looper thread rolling Unlike the call io BApptteaiiumKuJi, which docs not 
return, this call docs reium 
7 

RunO \ 

ff post initial message to get animation going 

PobiM essageCBB_TTCK): 


The TBa 1 Ts MessageReceived function handles the 
BBJTICK message: 

void TRtill ::MessageKeceived{^Message *msg) 

l 

switch (ms g->wha t J I 
case BBJFICK: 

Lockt)i 
Tick 0 1 
Unlock0: 

... ff sleep for a link bit of time 

ff post next message to continue animation 

PostHessage(BBJTICK): 

break: 

I 


The Lock() and Unlock () calls shown above deserve 
further explanation. The BeBounce application was designed 
so that the window “communicates" with the ball, not by 
posting messages to it, but by calling specific member 
functioas; see the definition of the TBall class. For example, 
one of those functions is TBall:: Set Gap (): 

void TBall::SeiCap(floai start, float end) 
t 

LockO; 

fGapStart - start: 

fGapEnd * end: 

UnlorkO: 


A consequence of this design is that two separate threads 
access the same da La structure, so some form of 
synchronization is required. The BLocker (also known as 


“blocker") class provides tills synchronization. Imagine if the 
locking was not present. Then in the middle of the looper 
threads calculation to determine if the ball hit that gap the 
window thread could come along and change the gap. Tins 
would lead to undefined behavior Code in TBounceApp:: 
MessageReceived (} locks the window for this same reason. 

An alternate design would have the window sending 
messages to the ball, in this case, locking would not be an 
issue. The act of posting messages implicitly provides the 
synchronization needed. The bail's looper ihread can only 
handle one message at a time. In this example the trade-ofif 
might be the latency of messages changing the “gap" position 
or starting and stopping the half with the Stop Ball menu 
item. The preferred method should be determined on a case 
by case basis. For educational purposes the BeBounce 
application uses both styles of programming. 

Back to the BB_TICK message. Most of the work in 
animating the ball is done in TBall: ;Tick(), and most of 
that code is the math and geometry needed to animate the 
bouncing ball and determine when the Ml either hits a wall or 
flies through the gap. As little of this code is specific to the 
BeBox we will not go into any more detail except to show how 
the ball draws. 

void TBall::Tick{) 

I 

// move ball to new position 

ff inform the window to redraw the window, 

BMessage “rasg - new BHessa&e(BB_ DRAW) ; 
m$g->AddRec:t{ "update 11 . updat.eRett) ; 
fWindow->PoEtMef3sage{rafT£): 

if (hlt_hole) I 

r 

The gap’ was till So we package up the info like speed ami relative location, 

which gives our partner enough information to have ihc ball appear in the 

correct place. 

7 

BMessage *nLsg = new BHessage tRBjnTJlOlR): 

... // adding info to message 

fWindow >PostMessag®(nag); 

\ 

\ 


The TBall: :Tiek() function moves the ball to the next 
position and then posts a message to the window telling it to 
redraw itself. Additionally, if the ball hits the “gap” a 
BB HIT HOLE message is posted to the window: 

When the window receives the BB DRAW message (in its 
MessageReceived function) it asks the ball to draw itself in 
its current location. The drawing is done by TBal 1 :: Drsw(): 

void TBalt;:DrawEBVlew 'view) 

I 

ff The bails draws ilsdf in the given view 

Luck(): 

rgb_color c - view->FrontColor0; 

vieiii->SetPeEiSizo{i.0) : 
view>SetFroniColor(150, 10, 10): 

view->FillArc(fGenter, {Radius, {Radius, 0.0* 360.0): 
view >SeiFronl: Color(c): 

Unlock(); 
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New in Version 5.0 

Jacobson, Fusion. Use 
Cases, Harel Statecharts, 
Interaction Diagrams and more 


Products are available by single* site or 
educational license and supported with on-site 
training, update service, Tree newsletter and 
technical phone support. Products include 
sample documents, tutorials and online help. 

Product Options 


MacAnalyst 

$ 995 

Mac Analyst/Ex pert 

$1595 

MacDesigner 

$ 995 

Mac Designer/Ex pert 

$1595 

MacA&D 

$2995 

Translator 

$ 495 




System Requirements 

^Macintosh System 7 with 8 meg RAM or 
UNIX with Apple's MAE software, 

) Winner of the 1994 CIO Magazine 
Readers 1 Choice Award, MacAnalyst 
and MacDesigner are used by thousands of 
developers worldwide for personal computer, 
mainframe and embedded software projects. 


Call now for free technical brochures! 


(Draw and verify your design, generate code or reengineer existing code 6ac&o diagrams . 


MacAnalyst 

& 

MacDesigner 


Excel Software 

515-752-5359 

P.O. Box 1414 • Marshalltown. 1A 50158 
easctools@aol.com ■ Fax: 515-752-2435 

MacAnalyst MacDesigner, MacA&D and Translator 
are trademarks of Excel Software. All rights reserved. 


OOA/OOD includes GMT. Booch 94. Coad/Yourdon. Shlaer/Mellor .. 


Software Engineering 

Structured Analysts & Design 
Object-Oriented Analysis & Design 
Real-Time & Multi-Task Design 
Data & Screen Modeling 
Integrated Code Editing & Drowsing 
Multi-User Dictionary St, Requirements 
Code to Design for C++* Pascal, Fortran... 
Design to Code for C++, Pascal, Fortran... 


Struct tired A AD using You rdo n/De Ma rc o v Gane/Sarson, Hatley/Pirhhai. 


Data modeling and SQL generation far Information Engineering, Chen 
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Quality: 

Compatibility 
8ug Reporting 
Test Plans & Suites 
Regression 
Metrics 

Engineering: 

Design 
Development 
Code Reviews 
Debugging 
Analysis 


22 Years of 14 Years 

Macintosh "Quality Development" Experience at 

Experience Apple 



Apple POWERLABS Engineering 

Computer 975 Town & Country San Jose, CA 95128 & Quality 

Partners (408) 24-POWER Assurance 


Hardware: 

PCMCIA cards 
MacOS Clones 
PCI/NuBus cards— 
Modems 
Printers 

Software: 

Drivers 
Applications 
CD-ROM Titles 
Extensions 
Utilities 


The view passed lo TBalli :Draw() is the same view 
that was added to the offscreen bitmap in the TWindov’s 
constructor, so the ball is being drawn offscreen. The window 
then gets the TBitmapView (described earlier) to blit the 
offscreen image onto the screen. 

The code for handling the BB_HIT_HOLE message is in 
TWindow::MessageReceived: 

void TWindow: :Hesj5flgeReceivfic|{SHsssage *msg) 

switch {mag >whnt) t 
crane SBJUTJIOLE: 

r 

The ball is idling un Urn ii jtisi hii ilic 
hate. Su u should |*d sail lo ihc partner, 

7 

BMcssagc “ new BHfiusage fBB_BALL); 
fSalI /Lock ()i 

m >A4riPolnt{“speed*% msg >FindPoint!"speed*]); 
nr >AddF1ool(*rel_luc:*, raEg->FindFloat("rei-ioc")): 
ntall >Unlock(): 

// send ibe ball u> i>ut partner 

®y_app - >SendTaFartner (■): 

// ikknc the bill ihiv window 

mu >Qu 110; 

rioll - NULL: 

// redraw the window 

Update(): 
break: 


... // handling of otJia - message 

I 

I 

Hie window responds to the BB HIT HOLE message by 
sending the BB_BALL message to the partner application giving 
it the ball. It puts die necessary information into the message 
so that the partner can create the new ball in the correct 
position, with the correct speed and direction. Finally, the 
window deletes die hall 

That is how the BeBounce application works. Obvious 
improvements to BeBounce would be to support more than 
two applications, multiple windows within the same 
application, and multiple balls. Another useful addition would 
be a separate control window with some controls for tilings 
like ball speed. Alt of these enhancements are feasible given 
the design of the Be operating system. To support an arbitrary 
number of applications each application would maintain a list 
of partners, having a BMessenger object to each one. 
Multiple balls in a window could either communicate with one 
another I for hit testing purposes) diredly or use the w indow 
object as the arbitrator. 

Hopefully this sample application has provided a taste of 
developing an application for the BeBux. The next question is: 
How do Be applications get built? 
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At ICONIX, we have a 10 year record of being 2 years ahead of the industry. Since 1985. we have maintained the 
foresight to consistently create products 2 years ahead of our competition. This year ; we've done it again... 


* 1995 - Maintaining the standard of excellence set by our popular "Object Methodology Overview" , our 
new “Unitied Object Modeling Approach" training CD ROM combines the best elements of Rumbaugh, 
Booch, and Jacobson methods, with prototyping, for full lifecycle modeling from requirements to code 
generation. And now, ICONIX makes its full suite of PowerTools™ available for the PC platform! 

PowerTools are now available for DOS, Windows 95, Windows NT, Windows 3.1, OS/2, Mac, 
NextStep, SunOS, Solaris. HP-UX, SGI IRIX, AIX, Alpha and Linux! 

* 1994 - ICONIX eliminates the "industry standard" UNIX price markup with our "one price all platforms" 
MOTIF releases for UNIX. Our SQA enhancements give users the ability to associate Requirements, Test 
Cases, Bug Reports, and Change Requests with dass T object, and use case models. 

* 1993 - Complete support for Integrated Booch, Rumbaugh, Jacobson, and Coad/Yourdon models. 

* 1992 - Addition of OMT support, and Integrated Requirements Traceability 

* 1991 ■ Initial Support tor OOA and QGD using Booch and Coad/Yourdon melhods. 

* 1989 - Support for Ada/OOD gets added to our existing real-time, structured CASE tools. 

* 1987 - We add multi-user capability to our tods, in support of large programs such as the Space Station. 

* 1985 - ICONIX pioneers easy to use, low cost, GUI-based CASE lods on the Macintosh, 



See The Future... 


You can wait 2 years and get left behind with our competition...or see the future NOW: 

Visit us on the Web: http://www.biap.com/icomx/, call us at 310458-0092, or email iconix@eworld.com 


U ICONIX 

Leadership in Object Technology™ 


Development Tools 

You write applications for the Be environment using tools 
supplied by one of the leading tool suppliers in the industry - 
Metrowerks. Currently tile preferred development environment 
is a Macintosh with the latest version of Code Warrior and Re¬ 
supplied headers and libraries. Using Code Warrior on the 
Macintosh, u developer can write, compile, and link a Be 
application. Of course, you have to transfer the application to 
i he Be Box before it will run. Since the BeBox supports ftp and 
includes a command-line shell (based on bash) the process of 
quitting your app, bringing over a new one from the 
Macintosh, and running it on the BeBox can be completely 
automated. There is also support for using the source-level 
debugger on the Macintosh to debug an application while ii is 
ninning on the BeBox. Metrowerks is currently working on a 
port of the full Code Warrior Integrated Development 
Environment to the Be operating system. This native version of 
Code Warrior, along with full technical developer 
documentation, will be shipped with every BeBox. 

Conclusion 

This is just a small taste of the BeBox. W'e have presented an 
overview of die Be operating system along with some sample 
code to give you the general feel of Be application 


development. To leam more about the Be operating system, 
please visit our web site, where we provide on-line versions of 
our developer documentation as well as information about our 
product and company. We encourage developers interested in 
joining our support program to mail in the developer form, 
which you can find on the web site. 

Be has many plans for the future. We are continuing to 
improve and add features to the lie operating system and 
development tools. We are also working on future versions of 
the BeBox, which will include more and faster processors - 
including a machine with four PowerPC 604 chips for the 
horsepower hungry. 

We hope this article has succeeded in whetting your 
appetite for Be programming. We look forward to seeing all 
the incredible applications we know developers will write for 
die BeBox. ^ 


Visit MacTech Magazine's Web site! 

http://www.mactech.conn 


January 19% * MacTeciiMagazine 


Opening the Bf.Box 


45 




















By Michael Hopkins, Symantec 


SYMANTEC 



This monthly column, 
written by Symantec’s 
Technical Support 
Engineers, aims 
to provide you with 
technical information 
based on the use of 
Symantec products. 


Q: 1 want ro be able to add files to my 
project, such as ReadMe files and 
notes, without having the project 
manager attempt to compile them. Is 
there any way to create an extension 
such as a .note extension in the 
SPM that does not use a translator? 

A: Yes, there is. Quit the SPM and open 
your Symantec C++ folder Copy the 
file ^norie^ from your Translators 
folder (the one with the THINK 
Project Manager icon) Lo your 
(Translators) Ibider (the one with 
rhe Symantec Project Manager icon). 
With RcsEdit, open the copy and 
choose Get Info for «none» from 
tiie File menu. Change the creator 
from KAHL to None, Save the file, 
and quit ResEdit. Now go back and 
launch your project in the Symantec 
Project Manager and choose 
Options... from the Project menu 
and go to the Extensions page. 
Type the name of the extension that 
you warn to use for your non¬ 
comp i led source files in the File 
Extension edit text box. Choose 
« none » from the Translator 
popup menu, click the Add button 
and then dick the Saue button. 



Q: When 1 run my program with the Symantec Debugger from 
the Symantec Project Manager, the source code window 
does not come up and the debugger palette buttons Go, 
Step. In, etc. are not active. What is causing this, and how 
can I fix it? 

A: This behavior is a result of your application being compiled 
with incorrect ' S T Z E 1 Hags. The tlebtigger ret\uires that 
your project has Background Null Euents and 
Multi Finder Huiare checked on the Flags popup menu 
in the Project Type page of the Project Options dialog. 
Without these flags, Power Mac DebugServices will not be 
able to communicate with your application. 

Q: i have written a brief program in the THINK Project 
Manager that is crashing my machine big time. The code is 
as follows: 

typedef struct [ 
int a. b; 

] Fan, *FooPtr; 

mainO 

I 

FooFtr toobut: 
int i, size - 100: 

foabuf - (Fooptr) mallac( gize+aizeof(Fool j; 
if (fembnf = NULL) 

GxlL (0); 

for ( i = 0: i < size: i++ ) 

l 

foobut'tij .a = 0: 
foobuf,b “ 0; 

\ 

1 
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Why is this causing me so much trouble? Is something 
wrong with malloc? 

A; No, malloc is not at fault. By not including <stdio.h> 
and <stdlib.h>, your compiler does not have a function 
prototype for malloc, so it is guessing (incorrectly) about 
the size of the argument to malloc. Instead of using the 
type s ize_t , it is assuming an int. To avoid this 
problem, always choose Require Prototypes on the 
Language Settings page of your THINK C Options 
dialog. With that option selected, this would have resulted 
in a compilation error ins Lead of a runtime error. 

Q: Can l use Quickdraw* GX with TCI and VA? 


A: Yes, it is possible. For starters, initialize QuickDraw GX in 
CApp: : ICApp () in the following manner: 

void CApp;:ICApp (] 

f 

Ix_CApp(4. 24000L, 20480L. 2G48L): 

// Initialize your own application data here. 

long graphicslleapSiEE! = 375; // about 2SK 

theCXClient = CXUewGraphiesCUent( nil* gGraphicsBfia pS Ize 4 
1024L, OL ); 

FailNIL't theGXClient ): 

GXEnterGraphics(): 

assert (GXGc[GraphicsEttor( nil ) != out_of_msmory): 

//etc. 

t 

You will need to declare theGXClieot as a member function 
of CApp of type gxGraphicsClient and include the proper 
header files in CApp.cp. Additionally, iL Ls a good idea to 
override CApplication: : InapectSystem() to check for 
the presence of QuickDraw GX. It is considered programmer 
error to call GX routines without verifying via Gestalt. () that 
GX Ls present. Finally, override CApplication: :Exit() in 
CApp using the following example: 

void CAppi:Exit( ) 

I 

GXExitGraphics[); 

GXDisposeGEAphic&Client( rayGXCl{ant ); 

//ettu 

x_GApp::Ex 11 £); 

1 

Q: Why does printf crash when I use it in a TCL project? ls 
there any way to use TCL in conjunction with the con,sole? 

A: Yes, there is. The console package does some special 
initialization that needs to lx, 1 done in place of the standard 
toolbox initialization that TCL does. To use the console with 
TCL, you should override CApplication: : InitToolboxO, 
like this; 

void CApp::LnitTool box ( void ) 

I 

eout« "initialize console package"<<endl: 


The call to cout in place of the standard 
CApplication:: InitToolhox () will initialize the 
toolbox and the console package. This wall enable the use 
of printf and lost reams routines with the console 
window. Note; You will need to add the 10Streams 
library and replace ANSI_small with ANSI. 

Q: How do I make an application (or the Project Manager) 
multi-session, so I can throw' it on a server and have several 
users run the application off of the server at the same time? 

A: Use ResBdit to open the application you want to share. 
From the File menu, choose Get File Info for the 
application, and click the Sharable flag. Sane the 
application, and Quit ResEdit. Your application can now 
be used by multiple users simultaneously. 

Q: I am w'orking on an application that prompts the user for a 
password, I need to be able to filter the edit text so that it 
displays bullet characters instead of Lhe actual password Is 
there an easy way to do tills in VA? 



Example of an Application that uses a Password Edit Text Filter 

A: Yes, You must first create a derived class from CDialogText 
in VA. Then override the DoKeyDownO method in the 
following manner: 

void cPasswerdText:moKeyDownl char theChar, Byte keyCode, 
EventRecord 4 nsacEvent ) 
f 

Boolean pass - TRUE: 
short ID; 

Str255 T.extStriiifi; 

switch (LheChar) 

I 

case TCL_CR: 
case '\x'\ 
case kEntetKey: 
pass = FALSE; 
break; 

case kEscapoOrClear: 

i£ (keyCode ~ KeyEscape} pass “ FALSE; 
break; 
default: 

GeiTextStringt textString ); 

if ( ! isalnumt theCh ar )) // pass spaces ami delete keys 

t 

inherited::DoKeyDown( theGhar. keyCode, macKvehi ): 
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MacForth Plus & o 
Power MacForth w 


The Language of Innovation is now 
available native on the Power Macintosh. 


FEATURES 

■ Royalty Free Turnkey 
Compiler 

■ Text Editor 

■ Online Glossary Tool 

■ System 7 Compatibility 

■ 68020 Assembler 

■ 68881/2 Co-processor 

Support 


■ High Level Graphics 

■ Toolbox Support 

■ Extensive Documentation 

■ Reasonable Upgrades 

■ Optional Tools Disks 

■ MacForth Plus $199 

■ Power MacForth $199 



4701 Randolph Road, Suite 12 
Rockville, MD 20052 

301-984-0262 Or 1-800 FORTH-OK (orders) 
Fax: 301-770-1675 Applelinkr CSI 


pass 9 False; 

J 

if (pass) 

I 

textString3 01 I I: 

text. String ; textstring[o]] = '»'; 

SoLTcxtSiHng( Lex LSI ring ); 

// add code to store anustl characters tyfscd here 

if (itsTypingTask && ItsTypingTask->CanStiilType()) 

( 

I'D = this-) 10; 

BroadcasrChange(dI ni agTextChanged, AID); 

I 

else 

its Supervisor■>DoKeyOown(theChar, keyCode, nsacEvent) : 

I 

Q: Can I use STL with Symantec C++? 


A: Yes, Symantec: C++ supports a modified version of STL, For 
best results, you need to use 8.0*3 of our Symantec C++ 
compiler Patches are available via anonymous ftp at 
itp://devtoo!s,symant 0 c,com/updaters/sym.cpp-va-td.update. 

Q: I’m using your new Pascal Universal Headers for THINK 
Pascal and I get pages of link errors. Why is this? 


A: When you use our Universal Headers, you need to make 
sure that you have the proper uses statements for the 
toolbox routines that you are using. You can no longer rely 
on the correct uses being used automatically. You will 
need to lx j very conscious of which interface file you use. 
See the Readme for further details* 

Q: I call the Placet) method of a CPanorama object 1 have 
created in the Main view using VA, but nothing happens. 
Place {) works fine for oilier objects derrived from 
CPane, What gives? 

A: Placet) t inherited from CPane, sets the data members 
hEncl and vEncl. which indicate the pane's position 
relative to itsEnclosure, In the case of CIconButton, 
for instance, itsEnclosura will be the itsMainPane 
member of the Document {itsMainFane is the 
CPanorama object that acts as the background of every 
view of type Main Window). Hence, calling the Place () 
member of a CIconButton visibly moves the button 
relative to the window. In the case of a CPanorama object 
however, itsEnclosure is actually itsScrollPane. A 
panorama’s Place() function will not visibly change its 
postion. You should instead call itsScrollPane-> 
Place () to move a panorama relative to the window. 


If you have a question or topic for a future Top len article, 
please send us your ideas. If you have found an answer to an 
obscure problem that has been eluding you. or you have a 
stumper, send it to topten@devtooIs + symantec.com, If we 
choose to use your question in our column, your submission 
will be immortalized in print, and we will mail you a cool 
Symantec T-shirt. 

Special thanks to: Glenn Austin. Mark Baldwin, Levi 
Brown, Craig Conner, Andy McFarland, Christopher Prinos, and 
Kevin Quah. 
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TCP/IP Scripting Addition The Internet Scripting Solution 


Tht? TCP/IP Scripting Addition allows you to quickly 
develop Internet client/server applications using 
AppleScript®. If you want to script with MacTCP™ and 
Open Transport™, here's your solution! 

♦ Supports ScriptEdflor, FaceSpan ™, and HyperCard™ 

♦ Build net-wise WebSTAR ™ CGI scripts 
and NetScape™ CCI scripts 

# Sample scripts include FTP, Gopher, 

Telnet, Post Office, E-Mail and more 

* Featured on the Apple® Internet Server 

Order now through the MacTech Mail Order Store at 
B05-494-9797 or other mail order stores 




Mango Tree Software, Inc. 

Box 1057 • Brookline, Massachusetts 02146 
617-327-8663 

hLLp://www h mangotree.com/bii:/rr(ango 


All trademarks are properties of Ihefr respective bolderv 

Contact Mango Tree Software foe site licensing and redistribution in forma (ion. 

Copyright © 19% Mango Tree Software, Inc, 



FTP Parameters 


3 


Set these par an 
(sending) files I 


FTP Host 
Directory 


Telnet Librs 


User ID 
Password 


Type of file tra 

O MacBinary File 


'W Description: 


Telnet Library vl .0 

Copyright © 1995 Mango Tree 
All Rights Reserved 


I-L 


■ Record Stop 


Run 


I 

set my_telnet^ 3 tream to telro 
tell my_tel net-stream 

try 

conriect(your_host) 
read—until—text ("lot 


ACME TECHNOLOGIES Introduces ... 



Internet Daemon for Macintosh 

FingerToys is fully customizable! Run it as a Finger daemon 
out of the box, or write your own backend in AppleScript. 
Frontier, or C/C++/Pascal to support other protocols. 

Acme Technologies ■ 54 Fairfield Avenue • Norwalk. CT 06854 
(203) 857-0631 


• Power PC Native 

* Threaded 

* Scriplable 

■ Real-time status display or 
background-only daemon 

• Use as WWW->Vmger CGI 
gateway 1'or WebSTAR 

Only US $79 

Demos and information 
available from 

http://www.acmetech.com/ 

Sales@acmetech.com 
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JAVATECH™ 


By Hillel N. Cooper man and Aparajita Fishman, Cambridge, MA 



Java Rules 


A Java FAQ 


This is the first in what will he several 
articles on Java and the Macintosh 
implementations. Watch this column in 
the future for a beginner lesson on Java 
programming and reviews of offerings 
fmm Natural Intelligence, Borland, Sun, 
and others for Macintosh programmers. 
- Contrih, Ed, jaw 

Considering the amount of hype 
surrounding Java, it is nearly impossible, 
without a lengthy and thorough 
investigation, 10 really understand what 
Java is all about, and to know what it 
can and cannot do for you. As an 
antidote to all the hype, we are going to 
try to give some honest answers about 
Java in this article. We hope it will be 
helpful as you decide about how to 
pursue this new technology. 

According to Sun's “The Java 
language - A White Pa per", Java is a 
"portable, interpreted, high-performance, 
simple, object-oriented” programming 
language. Buzzword-shy it is not. In the 
questions below we will look at Sun's 
claims and explain whaL they mean. 


1- What is Java? 

Java is a programming language. It is really that simple. Much of 
the confusion on tills topic is from people mixing up what Java 
will enable with what Java actually is. However, for the purposes 
of this article, Java’s importance is based on what it is currently 
capable of doing. That's whar we’ll focus on. 

First a little bit of history. In April of 1991 the Java 
development team (or “Green" team, as Lhey then called 
themselves) started work in a building located off of the Sun 
campus. Java was originally conceived as a programming 
language and operating system for consumer electronics devices 
(ie. set-top boxes). The team envisioned the technology being 
licensed in the same way that Dolby Systems licenses its noise 
reduction technology. While market forces shifted so that the 
set-top box market slipped away as a potential home for the 
Java technology, the Web appeared on the horizon as a likely 
candidate for Java-based interactivity. With this goal in mind, 
Sun introduced Java in May of 1995. Sun’s current marketing 
reflects the idea that Java is the “Internet application language.” 
We will try' to delve a little deeper. 

Yes, Java is a language but iL is also a concept and an 
approach to deploying applications. 

2. What Is a Java Applet? 

An we said before, many people confuse Java’s capabilities with 
what Java actually is. The primary task with which people 
associate Java Ls creating interactive content lor the Web. By this 
we mean a level of interactivity beyond the basic forms and 
buttons provided by a combination of standard HTML and CGI 
programming. An applet is a program that is called in the process 
of displaying IITML Calling an applet from HTML looks like this; 


Hitlel Cooper man & Aparajita Fishman Hillel Cooperman (coop® natural. com) and Aparajita Fishman 
t a para jiia@nalural.com) are, respectively, Chief Evangelist and a Senior Software Architect, at Natural Intelligence, Inc 
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<HTKL> 

<KEAD> 

(TITLE)Applet Page</TITLE) 

</HEAD> 

(BODY) 

<H4)This Is an examole of a Java applet:</MA> 
<HR> 

(APPLET CODE~oyApp)ei.rlase wi«ith=100 height-50) 
</APPLET) 

<HR> 

(/BODY) 

(/HTML) 


Sample HIM 


import browser.applet; 

Import awt.graphics: 

class myappiet extends Applet I 

public void paint(Graphics g) 1 

g.drawstring("Hello world.* 

1 


Sample Applet 


25, 25); 


When a Java-enabled web browser (such as Hotjava or 
NeLsca|K*) encounters the APPLET tag, ii loads die Java class 
(applet) referenced in the quotation marks. Once loaded, the 
browser runs the code contained in the applet and performs 
whatever function is specified by the code. 

Having applets run in your web browser wouldn’t lx* such 
a great feat if they weren't small enough to be loadable in a 
relatively short [xrkxl of time; interactivity on the web is not 
very interactive if it takes an hour to load an applet. Just as 
Macintosh applications are built upon the Macintosh Toolbox, 
which provides a significant foundation of core functionality, 
Java applets are built upon Sun s AWT (Abstract Window 
Tixilkit), a class library which provides applets with their core 
functionality* Anti just as the Macintosh Toolbox resides on 
each user’s machine, so too is AWT a pan of each user's 
browser, obviating the need to load AWT over the net. The 
end result is that Java applets tend to be very compact, which 
translates into faster load times. 

3- Is Java Only G<x>d For Creating Appijts? 

Currently there are two options when using Java* The first is to 
create AWT-bascd applets which can only run within a Java- 
enabled browser or application. The second is any programs 
which use only console input and output. Although used 
mainly for applets now, Java is a robust, general purpose 
language with many possible applications. 


4_ Flow Easy Is It To Go From C/C++ To Java? 

It is very easy. 

One of the Java team’s stated objectives was to keep the 
language familiar to the majority of programmers* Java’s 
expression syntax is the same as Cs and it incorporates the key 
object oriented features of C++. This was done to give 
programmers a common reference fxmil when porting their skills 
to Java. And, from our ywrapective, Java provides most of the 
power of C++ with none of the pain. This was achieved by 
avoiding those ‘‘features* of C++ which, while providing 
tremendous power for those *in the know/ are a source of 
tremendous complexity and befuddlemenr for most programmers. 
In particular there are two potential pitfalls in C++ that Java 
avoids; raw pointers and multiple inheritance. In place of 
pointers, Java provides true type-safe arrays and strings* as well as 
runtime type-checked dynamic casting 

5* Are Java Applets Cross-Put+orm? 

The Java specification actually consists of two parts, the 
language specification and the Java runtime environment* The 
language specificsion* like any other programming language, is 
independent of the platform on which it is deployed* Java's 
runtime environment is a byte code virtual machine (VM> 
interpreter Lhat allows an applet to run on any given platform. 
Think of it as a simulated CPU with a platform neutral machine 
language. 

The Java compiler compiles Java source code into Java 
byte code, and this byte code is executed by the virtual 
machine. Because the Java environment and virtual machine are 
pi at form-in dependent specifications anti have been ported to 
multiple platforms, compiled Java applets are themselves 
platform-independent. 

There are two browsers that are currently available (or are 
about to be available) that run Java applets. Hotjava is .Sun’s 
Java-capable browser (w ritten in Java) that runs on Solaris and 
Windows NT. As of this writing, beta versions of a Java- 
capable Netscape browser are available on Solaris. Windows 
NT, Windows 95, and of course Macintosh* 

6. Will Java At row Viruses and Destructive Programs 
to he Transmitted Via the Net? 

As we mentioned before, Java applets are built on \WT. AWT 
provides two levels of security. On the first level, AWT 
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prevents applets from having free access to your computer’s file 
system. So, for example, it would be extremely difficult for 
someone to write a Java applet which did any damage to your 
computer's files. The second level of security involves a byte 
code verifier in the Java virtual machine. The verifier checks to 
see if any of AWT's security classes have been overridden or if 
anything in the applet will make the browser crash. If both 
conditions are met, it allows the non-offending applets to run 
in your browser. Otherwise, it rejects them. While a good 
concept, the verifier can be fooled; be careful 


7- How Fast is Java? 

The real question is, “How fast is Java in relation to oilier 
programming languages?" The answer is, Java falls somewhere 
in between the speed of static languages such as C/C++ and 
dynamic languages such as SmallTalk. Preliminary benchmarks 
show that Java byte codes typically execute ai about 50% of the 
speed of well written C code for processor intensive tasks. The 
bottom line is that Java is significantly faster than dynamic 
languages such as SmallTalk and interpreted languages such as 
Visual Basic, The secret to Java's speed is the design of the 
virtual machine instruction set. The Instruction set is dose 
enough to most native CPU instruction sets that there is very 
little overhead in translating from Java byte codes to native 
instructions. Future versions of the Java byre code interpreter 
will be able 1 to translate from Java byte codes Lo native machine 
code on the fly (also known as “Just-in-time compilation"), 
which will result in even greater execution speed. 


8. Why Does Java Have “Automatic Garbage Collection” 

AND “MULTI-THREADING”? 

OK, so that's really two questions. One of the priorities in 
creating the Java language was to keep the language simple. 
Or more specifically, the goal was to avoid a lot of the 
complexities of C++. One of the common complaints about 
coding is the work you must do to manage your memory, not 
to mention the consequences if you don't do it property. 
Studies have shown that up to 50% of a programmer's time, 
when using non garbage-collected languages such as C and 
C++, goes into managing memory storage. And, a significant 
amount of debugging time goes toward tracking down 
men u ) ry- re la Led 1 >ugs. 


The beauty of the Java Virtual Machine is that it takes care 
of memory management for you. This process is called 
“automatic garbage collection,” A low-priority thread 
periodically scans your applet's memory for unused objects and 
recycles the memory they were using. It does this by keeping 
track of what parrs of your program are using memory, and 
determining when those chunks of memory are no longer 
needed. Many programmers mistakenly think that garbage 
collection is inherently slower than manual memory 
management. This impression stems from the fact that up until 
now, most mainstream languages that used garbage collection 
were interpreted anti thus inherently slow themselves. In fact, 
a well implemented garbage collector is on average as fast U 
not faster than the best implementation of manual memory 
management. A well-implemented garbage collector can be 
faster than manual memory management because it can reclaim 
unused memory in one fell swoop instead of in hundreds of 
small increments. 

As for multi-threading, we just saw one very gtx)d use of 
multiple threads* Aside from garbage collection, today's fast 
microprocessors can easily support multiple threads of 
execution, allowing more flexible and robust solutions Lo many 
classical programming problems. For example, any 
asynchronous task, which requires polling of a state flag, can 
be spun off into a separate thread allowing the main thread of 
execution to continue unabated without worrying about the 
result of the task. 


9. What is the Future for Java on the Macintosh? 

As we mentioned above, Netscape is planning to release a 
Macintosh version of its browser that is Java-capable. 
Programming in java on the Macintosh is a different story 
altogether. There are currently two options. As of this writing, 
Sun is planning on releasing a Macintosh version of their Java 
Development Kit in early 1996. By the time you read this 
article, Developer Release 1 of Roaster™, the other option on 
the Macintosh, will be shipping* No discussion of java in a 
Macintosh programming magazine would lie complete without 
mention of Roaster. However, Roaster is a product from our 
company, Natural Intelligence, so TU keep the marketing to a 
minimum and give you the basics. 

Roaster is an integrated development environment for 
writing Java applets. Roaster consists of several components: 
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Project Window 


Source Code Editor 


Runtime Engine 


Compiler 


Tills is used Tor the organization of 
your source code and compiled byte 
codes in a Finder-like view. 

The editor includes a toolbar with a full 
suite of code-editing functions, context- 
sensitive color and style syntax 
formatting, and drag and drop support. 
This allows you to put up a native 
window in which you can test your 
applets. 

The compiler generates Java byte codes. 


We're including this description in the article to give you 
an idea of what will be in Natural Intelligence's Macintosh 
applet development environment for Java. But hopefully* Sun’s 
environment will lie out soon, so that you will have more than 
one option for developing in Java on [lie Macintosh. 
(Metrowerks has announced support for Java development as 
well. See Netvsbits. - Ed. Asst, jtkj 

10, Where Can I Get More Information? 

1 always balk at putting references to the net in articles that 
won't be published until weeks after they're written. The net is 
so dynamic that they may end up 1 icing out of date. So cross 
your fingers and check out these resources. Most should still be 
relevant by the time you read this, though Tm sure that there 
will l>e many more by [lie time this is published. 


Java Home Page http:tfjava.sun.com/ 

John December presents Java 

http://www.rpi.edu/-decemj/works/java.html/ 


Java five 

Natural Intelligence, Inc. 

Gam clan Java Resource Registry 
Java Usenet Newsgroup 
Java-Mac mailing list 


http:tfcatalog.com/dddu/javajlve.html/ 

http;//www. natu ra I .conn/ 

http://Vvww.gamelan.corn/ 

news:comp.lang.java 

send “subscribe java-mac" to 

majordomo@natural.com 


These are just a few of the resources out there. Keep your 
eyes peeled for the inevitable avalanche of books and 
magazine articles on the subject. 


Summary 

In closing, despite your natural reaction (as a marketing savvy 
programmer) to dismiss the hype surrounding Java, there really 
is something to get excited about. While Java has its 
limitations, it is a definite leap ahead of today's industry 
standard programming languages and approaches, With your 
support of the language, there is no doubt that Java will 
continue to thrive in the future. 
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By Dave Mark 



Java Talk 


iou, the MacTech rmdership, haw been 
long asking for a Metrowerks presence in 
the magazine: 'Ibis is the first in a brand 
new series of articles by longtime 
MacTech columnist Dave Mark, Dave 
recently joined forces with Metrowerks to 
produce a series of CD-ROM based 
programming products. This month, 
Daw interviews Greg Galanos, president 
and CEO of Metrowerks, about 
Melrowerks ’ recent announcement on 
their new Jam development environment. 

Dave: Metrowerks just announced the 
first Mac-based Java development 
environment. What can you tell me 
about it? 


bring them to our user base as a first developer release in May. 
This means well support source-level debugging, browsing and 
compiling as if you were working with C/C++ or Object Pascal 
within the IDE. 

Dave: If you want to produce Java applets, you’ll have to learn 
the Java programming language, something akin to learning 
C++. Do you think Metrowerks will ever offer a way for non- 
programmers to produce Java applets? 

Greg: Ahh, the holy grail*,,. Metrowerks is committed to 
building better, easier-to-use tools. I suppose the cryptic 
response would be to say that we will support Java in much the 
same way that Borland wall support Java..*, The answer here is 
Lhal we will strive to do so but it's not a short-term proposition, 
This w ill take time, but yes, we arc moving quickly towards that 
goal and will be taking Constructor down that road. 


Greg: We’ve been tracking Java for over 
a year now, noting the developments in 
the field and Lite positioning of the 
language with respect to Internet 
development. A little over four months 
ago, we initiated contact with Sun and 
developed a complementary position in 
order to properly support Java 
programming and Internet development 
within CodeWarror* 

'1’lie Sun deal was signed a couple 
of days before Comdex, It is both a 
licensing and a development deal where 
Metrowerks will license compiler 
technology, runtime interpreters, Java 
classes that support cross platform 
development, as well as the Ilotjava 
browser. These technologies will be 
seamlessly merged with the CodcWarrior 
Development Environment in order to 


Dave: What is Sun's role in all this? 

Greg: Sun has been working on different manifestations of Java 
for about 5 years. It came oul of some pretty serious K&D 
efforts into embedded appliance systems. It was found at that 
time that C++ w r as not ideal for embedded, secure development 
because of what Sun oils unsafe language features: pointers, 
operator overloading, multiple inheritance and the absence of 
garbage collection. (Note: multiple Inheritence is available in 
the Java interface, but not in the classes themselves). Java is a 
language that is very dose to C++ without the feaLures that are 
considered insecure or dangerous, especially for a languge 
designed for building programs that are downloaded to your 
desktop machine and which will then run there. 

Sun is doing some very interesting things in order to 
nurture java and cross-platform Java implementation* For 
instance, Lhey are licensing liicir technology and working with 
strategically chosen desktop partners in tools (Metrowerks, 
Borland), communications (Netscape, Spyglass), content 
development (Macromedia, others). But they are also 
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World Wide 


Web Weaver 




for Macintosh 




The professional web page development tool 

* Tables 

* Forms 

* Page Colors 

* Add your own tags 

* And much much more! 



r / 


For & fully functioning demo, point your web 
browser to htlp://wwwmorthnet.org/besl/ 


Best Enterprises (315) 265-0930 


controlling the technology and the language standard until the 
language is emlxdded, so to speak, in Internet development in 
order to stave off the feariiritis that comes from standards 
committees (I point to C++ as a specific example of this). This 
is a gtx)d thing — actually the reverse of what usually happens 
with a new language. 

Finally, Sun is controlling and furthering the security 
technology that will guarantee that a Java applet is, in effect, 
secure. Fart of the technology licensed from Sun addresses the 
areas of security and validation, what is applied to the Java byte 
code stream once it passes the threshhold of your particular 
desktop machine, 

Merrowerks and Sun have teamed up lo ensure that 
Macintosh plays an inifxmant role in Java development. This 
relationship is both one of making the tools available to our 
customers in a timely manner (WWDC) and also working with 
Sun on market-creation strategics. MW lias licensed all the Sun 
technology and will be rolling new technology into its Java 
products as time progresses. Of course, Metrowerks will also be 
developing new technology for Java, optimization techniques 
for runtime improvements, AWT (abstract windowing toolkit) 
support, interface building tools, etc. This is a king term play 
for us and we intend to support our customers in their quest to 
program the net and increase their own revenues. 


Dave: Will developers have to pay any royalties on applets 
they build using Java Works? Arc there any licensing issues 
developers need to he aware of? 

Greg: Wow, ‘JavaWerks"! Quick, let's get a trademark! Seriously 
though, applet developers shouldn't have to worry too much 
about licensing issues unless they are also shipping the byte 
code interpreters. Sun is striving lo make this technology an 
open platform; therefore there are no direct royalties or other 
costs associated with developing and shipping applets. Java 
implemented such as Metrowerks and ihe other Java official 
licensees bear Llic burden of the royalties in a distributed 
manner, so it makes a lot of sense from a developer's 
standpoint. The implemented are held to a very high standard 
and must pass all sorts of validation suites before shipping their 
Luolsuite. This is because Sun absolutely wants Java to be cross- 
plat form, and for this to be achieved much more validation 
must be applied to the tools lo ensure that the compilers 
generate the proper byte aide for any particular release, 

Dave: What impact do you think Java applets will tiave on 
more mainstream application development? For example, do 
you think we’ll ever see a Java word processor or spreadsheet 
applet? If so, how will folks pay for it? 

Greg: I think there are really two markets here. The hrst is the 
development of applets or small applications that live on a Web 
server and execute a specialized function that an end-user 
wants to acquire. I'll take the easy example: Imagine a 
specialized applet that implements peer-to-peer communication 
with a stock quote server (local Java applet talks to remote Java 
applet) and warns you when you should buy or sell. An end 
user is likely to see value in this applet and lx- prepared to pay 
a price of (let’s say) $9,95 a inonili for this service. Result: 
applet developer sells to end-user without traditional 
distribution channel. There are many, many examples of this 
from gardening, to cooking, to special travel deals, that a 
consumer will be interested in procuring in the home directly 
from tile service provider. 

The second market is for today's applications vendors (our 
customers) to hotwire their application to the Internet either by 
implementing applets in their application suite that can lx* sent 
off across the net to “do something* or by embedding applet 
technology in their application lo host applets that are 
downloaded from the net. This could lx* as simple as running 
the applet in a web browser, or as complicated as allowing the 
applet to actually "plug in n lo the application itself. Again, the 
consumer could then choose from any specialized applet that is 
destined to work with Claris Works or FreeHand or Illustrator, to 
give a few- examples. Look at die Java runtime model as a very 
lightweight, muhi-threaded container architecture without SOM 
and the fragile base class problem that happens to be the 
Achilles’ heel of C++, Tills is a powerful concept. 
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Make Your Macintosh An Internet Server 

Mach'' gives every Macintosh from Classic to PowerMac & PowerBooks: 

1. Unlimited Web ‘Home’ Pages 

2. Unlimited TCP Connections 

3. Unlimited Mail Accounts 

4. Unlimited Internet Addresses 

5. Unlimited Domain Names 

6 . Domain Name Service (DNS) 
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Mac OS and UNIX on a single 
machine: the best of both worlds. 

Madias a compact UNIX operating system that runs seamlessly with 
tlie Macintosh operating system to let your Mac reach its full potential 


For more information, or to order call 


7. POP Mail Service 

8 . Mac/UNK File Sharing 
9* Mac/UNIX Printer Sharing 

10 . Unlimited Possibilities 
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Dave; Java is normally compiled into byte-code, then 
interpreted, Will there ever be a fully compiled Java with no 
interpreter in the loop? 

Greg: Essentially, the byte code runs on the Java viiLual 
machine (the interpreter) which translates the byte-code into 
native instructions. 1 think you'll see both just-in-time compilers 
and hybrid dyna m ic/intepreted compilers that will be necessary 
to speed up local execution. So the answer is Yes. The real 
question is: "When?” 

Dave: Where am people go 10 get more information? 

Greg: Well, the fastest way to get to all the hot java sites is to 
go to http://www.metrowerks.CQm, We have a full hookup to 
Licenses sites, user sites, Sun's numerous sites. The other place 
you can go is to http://java.Siin.com (but we point there tod). 
There's also the newly created newsgroup news:comp.lanpjava 
which has nearly as much traffic as 
comp,sys,mac.pmgtammer,CQdew3rrior. The Java newsgroup is nearly 
absent of Mac programmers, who have noi had the tools to 
date. We definitely are going to change this. You can also send 
email to java@metrowerks.com to receive info on l>eta testing. 


Dave: Who the heck is Duke, and why is lie stealing Ahnold s 
limelight? 

Greg: Hey, Duke s cool. He's the Java mascot, a molar-shaped 
imp with a red nose carrying a surfboard, i can just see Arnold 
surfing the web jolted out of his brain on this Java stuff. 
Arnold and Duke are buddies. Arnold is Duke's protector. Like 
Ten t lin a tor 11, yea h. 
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INTERNET 

SOLUTIONS 


By Brad Schrick and Eric Bickford 



Becoming a Macintosh Service Provider 


Tales from the field 


For several months MacTech has 
published articles explaining how to 
configure and program Internet WWW 
servers. Of course, Macintosh Web 
development isn't jusi programming: 
there’s money to be made! Eric 
Bickford and Brad Schrick, two 
professional Macintosh WWW 
developers, report on market conditions. 
The forecast is sunny. 

Eric Bickford 

It began innocently enough. Put up a 
few web pages and see what happens. 
Seven months later the Mac Web Con¬ 
sultants Directory http://www.macweb.com/ 
had received listings front 440 
consultants in 20 countries throughout 
the world (80% of those in the USA). 

The Mac Web Consultants Directory 
was launched in April 1995 at 
WebEdge I, the Macintosh WWW 
Developers Conference. The idea 
behind the Directory was simple: 
Provide a searchable database of 
consultants who are experts in 
electronic publishing on the World Wide 
Web using Apple Macintosh and 
compatible computers. 


Listing 

To register, a consultant need only complete a free online 
application form. The application form asks for contact 
information and a short description of the services the 
consultant offers. This description becomes the consultant’s 
primary vehicle for attracting clients who search the Directory. 

The application form also has a skills matrix for Services, 
Scripting Languages, Database Programs, and Web Tools. Any 
Individual consultant might be skilled in CGI programming 
using AppleScript, C++, or Frontier. They might lx? skilled with 
a Macintosh database like 4th Dimension, Bullet, or FileMaker 
Pro. Or, they are skilled in a specific web-related tool like 
AppleSearch or NetCloak. 

Once a consultant creates a profile, they have the capability 
to update their profile at any time. Should a consultant be 
unavailable, for example, they're encouraged to update their 
availability status to “Booked Solid". 

Searching 

The Directory’s web-based search screen is very simple: 
Select the field you wish to search, such as “City", and enter a 
search term. Results of a search are returned as a httlisr of 
records with consultant contact and profile information. Small 
icons on each consultant profile give an indication of the 
special skills that a consultant might offer. 

The individual consultant must sell himself. Each listing in 
the Directory should have a URL pointing Lu the consultant’s 
home page. The quality of a consultant’s home page is often the 
primary selling paint for acquiring new projects. 

It Actually Works 

Large and small companies and organizations use the Directory 
to find experts to help them build mission-critical, industrial-strength 


Brad Schrick and Eric Bickford - Brad Schrick is a consultant in Palo Alto, CA. Eric Bickford is the author of Web-FM and 
a product development engineer for the Web Broadcasting Co. in Palo Alto, CA, 
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The #1 debugging and development environment for AppleScript ! 



• Real step-by-step debugging 

• Variable watcher & 
expression evaluator: set 
variables, in context, during 
debugging! 

• Enhanced trace log 

• FaceSpan™ link 


* Vocabulary access in a 
mousecliclc 

* Power-assisted statement 
construction 
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Main Event 


1 800 616 8320 


ORDERS 

ONLY 


I f you're an AppleScript novice, Scriptcr will take you by the 
hand and show you the correct syntax for your statements 
If you know what you're doing, Scripter will help you do it 
faster than any other editor. Scripter lets you debug properly: 
truly line-by-line, so you catch the offending code in the act. 
And only in Scripier can you then fix the problem, and 
continue debugging right from where you left off. In foot, 
Scripter has so many exclusive features, we can't list them all 
here. So get a copy today, and start scripting with power! 

"Overall value ♦♦♦♦♦ 

Scripter 1.0 is top AppleScript editor and debugger... 
If you expect to do anything more than idle fiddling 
with AppleScript you need Scripter." telteei S/12/95 


+1 2022989595 mainevent@his.com AppleLink: MAIN,EVENT 


solutions on the WWW. Its rewarding when you plan and I mild 
something like this Directory and it actually works. Again and again 
1 find I'm talking to or reading email from someone in the directory 
who mentions getting a project or referral from it. 

The Directory, however, isn’t without some problems. Because 
listing as a consultant is free, some people have listed themselves 
who arguably should not Ik: in the Directory. For example, a quick 
search of the Directory finds that not ail consultants have a home 
page URL Likewise, an even 10% of all consultants listed have an 
email address with an .edu university top-level domain. 

Brad Schrick 

In mid-1993 Chuck Shoiton wrote MacHTTP, and showed that a 
Macintosh could be a comjxienL server on the Work! Wide Web. 
By late 1994 there was a lively group of commercial, educational 
and personal Mac OS WWW servers using MacHTTP on the 1:1). 

Show me 

However, despite these many examples and an active 
discussion list, even Macintosh advocates often believed that 
UNIX was required to serve pages On the WWW, Instead of 
arguing endlessly. Brad Schrick. a MacHTTP advocate and 


customer, decided to try to list the servers that use Mac OS to 
deliver World Wide Web services. 

The list debuted in October 1994 

The first listings were easy to choose, starting with Chuck s 
site on his Ilci at the University of Houston (now 
www.biap.com), Apple's front door, tended by Dale Mead at 
WWW.apple.com on a Mac Tlfx, Stephen Collins’s Web66 WWW 
cookbook’ at web66.coled,umn.edu (with several other Mac 
WWW sites), Jon Wiederspan’s CGI tutorial < http:// 
www.uwtc.washington.edu/computing/www/lessons/) at the 
University of Washington, and about 50 others. 

Over the past year, the lists were automated to allow Mac 
webmasters to enter and change their own listings, and the lists 
were grouped by new listings, geography, equipment, and 
software in a continuing process to help Mac webmasters 
evaluate techniques and markets For their work. 

The Mac WWW Server lists at http://brad.net/macwww/ 
currently hold about 1100 listings for about 900 to 1000 distinct 
Mac servers from around the world, and are growing at a pace 

Continued on page 94 
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By Alan B. Oppenbeimer 




Inside HomeDoor 


Make one web server act 
like a net work of servers 


The HomeDoor™ Default Home Page 
Server is a newly-announced product 
from Open Door Networks. HomeDoor 
enables a single Macintosh Web server 
to serve default home pages for multiple 
domains. This article describes the 
inner workings of HomeDoor, 

Product Summary 

HomeDoor is a Macintosh extension and 
associated Admin application which 
enables an Ethernet-based Macintosh to 
redirect requests for particular default 
home pages to particular subdirectories 
on any Web server. For example, 
HomeDoor can redirect URLs of the 
form http://www.companyXxom/ to the form 
http://www.yourwebserver.com/companyX/. 
HomeDoor supports up to 2% such 
redirections, allowing you to set up a 
large number of default home pages on 
a single MactXS-based Web server, 
HomeDoor also supports the creation of 
complete “virtual” domains associated 
with each of these home pages. 

The Web server (or servers) to which 


HomeDoor redirects requests tit? not necessarily have to Ik* in the 
same machine, or even on the same network, as HomeDoor. You 
configure HomeDoor with a unique ll J address for each default 
home page it is going to save. You will also generally want to 
assign a domain name, such as www.eompanyX.com, to each of 
these addresses. For each address, you then configure HomeDoor 
with the URL to redirect that address to. When HomeDoor gels 
an HTTP request to one of the addresses it s managing, it redirects 
that request to the configured URL. HomeDoor can lx.’ used to 
serve default home pages in this manner, and also to serve full 
“virtual" domains, redirecting not only URLs of the form 
http://wwwcompanyX.com/, hut also URLs of the form 
http://www,companyX,com/file-or-directory, When redirecting such 
URLs. HomeDoor preserves the Hitc-or-directory 11 part, thus 
supporting the creation of complete virtual domains. 

Multihoming—T in- Key to Homi;D<x>r 

The key architectural component of HomeDoor is multihoming. 
Multihoming is the ability of a single physical node on a 
network to have more than one address {or “home") on that 
network. Neither Mac TCP nor the TCP IP implementation in 
Open Transport provides multi homing, although Apple intends 
multihoming to be a feature of Open Transport 2.0. HomeDoor 
thus had to implement a simple form of multihoining itself 
HomeDoor s multihoming is limited to those Internet protocols 
required for HTTP (specifically ARP, IP and TCP), plus a small 
subset of ICMP so that HomeDoor can respond to pings for its 
addresses. HomeDoor does not provide a general-purpose 
implementation of multihoming. 

HomeDoors multihommg is implemented directly on top 
of the Macintosh Ethernet driver, below the TCP/IP stack. 


Alan il Oppenheimer - Alan IT Oppenhcimer was part of the original team that created the AppleTalk network system, 
Alan was responsible for the design ol many of AppleTalk's lower layer protocols and led the team at Apple responsible for 
the Apple Internet Router and Apple Remote Access. Alan left Apple to fountl Open Door Networks. Inc, in January of IW 
Alan's email address is alan@opetidoor.com. 
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HomeDoor tells the Ethernet driver to pass it all packets of 
Ethernet type ARP” or “IP/ Because of the way the IP protocol 
suite works, the packets Home Door needs ro receive are either 
broadcast (ARP packets), or sent directly Lo the Macintosh \s 
Ethernet address UP packets). This fact Ls important, because it 
[Prevents HomeDoor from needing to have the Ethernet driver 
listen to every packet sent on the network, which would 
adversely affect performance. 

Alter being passed an ARP or IP packet from the Ethernet 
driver, IIomeDoor determines if the packet is intended for an 
address in its address range. If the packet is in range, 
HomeDoor processes the packet as appropriate* implementing 
the required parts of ARP* IP, TO 1 or ICMP, If the packet is not 
in HomeDoor s address range, and MacTCP is running, 
HomeDoor passes the packet to MacTCP* Otherwise 
HomeDoor discards the packet. By passing packers ro MacTCP* 
HomeDoor can run on the same Macintosh as any MacTCP 
client or server* anti specifically in the same Macintosh as a Web 
server for which it is serving default home pages. HomeDoor 
does not, however, require MacTCP lo run. HomeDoor also will 
not currently run at ail on a Macintosh which is running Open 
Transport, due lo OTs radically different driver architecture. 

Redirection 

As shown below in figure l s HomeDoor takes advantage 
of a feature in HTTP known as redirection. A browser wishing 
to look at a Web page issues an HTTP GET command to the 
address indicated by the first part of the URL, after obtaining 
that address from a domain name server (DNS). If the address 
is being managed by HomeDoor. HomeDoor receives the 
request and returns an HTTP REDIRECT in response* The 
REDIRECT contains the actual URL of the associated default 
home page. The browser receives the REDIRECT and then 
requests that page directly from the actual server* using the new 
URL* From then on, the browser talks directly to the Web 
server if other (relative) links on that server are accessed 
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Virtual domains 

To l*e precise, HomeDoor actually does more than simply 
returning, in the REDIRECT the URL that has been configured 
for the address requested. Technically speaking, HomeDoor 
actually replaces the part of the URL which specifies the Web 
server itself with the URL to be returned. So a URL of the form 
http://wwwxompanyXxom/ is returned as 
http;//www.yourwebserver, com/com panyX/, but a URL of the form 
http://www.companyX.com/file-or-directory becomes 

http^/www.yourwebseryeccom/companyX/file^or-directory. Since the 
“file-or-directory" part can in fact be arbitrarily long, a full 
"virtual* domain can be served by HomeDoor. 

Completing the illusion 

HomeDoor effectively allows a single Macintosh Web 
server to serve default home pages, and in fact full virtual 
domains, for up to 256 different domain names. HomeDoor 
does so in a manner that is almost totally transparent to Web 
browsers. The only significant exception is that most browsers 
display a page’s actual URL in their iocatioiT F leld. Thus, For 
example a browser user would see the URL 
http://www.yourwebserver.com/companyX/, even though they typed in 
or accessed the URL http://www.C0mp anyXA Even this minor skle- 
cffect, however, can be eliminated by using n DNS to set up an 
appropriate alias to the actual Web server, and using 
HomeDoor to redirect to dial alias as opposed to to the Web 
server itself* For instance, instead of redirecting 
http://www.companyX.com to http://www.yourwebserver.com/companyX/, 
you could redirect it to http://www2.companyX.com/companyX/, 
where www2xompanyXxom is an alias for www.yourwebserver.com. 
In this way, not only will the Web browser user see the correct 
domain name in the location” field, hut it will appear to the 
user that the domain in question has not one but two complete 
Web servers associated with it (wwwxompanyX.com and 
www2.companyX,com). 

Subtleties of HomeDoor 

The HomeDoor design contains a number of subtleties 
which might not be immediately apparent. These subtleties are 
based on the fact that HomeDoor allows you to enter a Full 
URL for each address it is managing. This flexibility allows, for 
instance, a single HomeDoor server to serve home pages and 
virtual domains for more than one Web server. And, although 
HomeDoor runs on a Macintosh, there is no reason that the 
Web servers themselves need to lx: Macintoshes. HomeDoor 
can serve default home pages for any type of Web server 
whatsoever, HomeDoor can also redirect URL's to other 
network services, allowing, for instance, an HTTP URL to lx 
redirected to an FTP server* Finally, with some small 
modificalions T the HomeDoor architecture can be enhanced to 
provide many additional services* One area for immediate 
investigation involves having HomeDoor redirect a particular 


URL to a URL chosen randomly or sequentially from a group of 
other URLs t enabling HomeDoor to serve as the from end to a 
Redundant Array of Inexpensive Computers (RAIC). 

How To Find Out Mori: 

Open Door Networks maintains a complete set of home pages 
on the HomeDoor product. Not only do these pages include 
product details, example pages served by HomeDoor and a full 
copy of the HomeDoor Users’ Guide, but also a downloadable 
evaluation version of die current release of HomeDoor The 
HomeDoor pages are at http://www,opendoorxom/homedoor/ T 
General information on Open Door Networks, one of the first 
Macintosh-based Internet service providers, is available at 
http://www.opendaor.COfn. Specific questions should be addressed 
to help^opendoorxom. 

[For those of you that would like to see a real life 
example of this technology, we use HomeDoor on one of our 
servers in the Xplain CorpJMacTecb offices. In fact, the 
www. mactechxom and wtmiKdeveentral.com web sites are 
redirected using HomeDoor This allows us to have an all 
Macintosh Internet site without having to resort to Unix , We re 
verypleased with this solution. 

There are some minor limitations to the way that 
HomeDoor works (although it does benefit from an all 
Macintosh user interface). If you want a different solution , 
Unix does offer the most complete "multi-homing" solution 
available. And. if you want to stay with the Macintosh (and 
why wouldn 'tyou?) f ihett MacbTen from Tenon is your answer 
- it's a kinder, gentler Unix. :) - Pub. nstj 
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By Mason Hale <bale@onr.com> 




CGI’s: AppleScript or Frontier? 


Comparing scripting 
environments for CGI 
development 


In a previous article, “Scripting the Web 
with Frontier 1 ’, I introduced you to writing 
CGI scripts using Userbmd Frontier In 
that article, I argued that Frontier was an 
excellent alternative for webmasters who 
felt forced to choose between die poor 
performance of AppleScript and the steep 
learning curve of C because Frontier is 
easier to use than C yet generally performs 
faster than AppleScript, especially when 
used to create CGI applications. That 
argument became even more true when a 
PowerPC-native Frontier was released for 
public Ixjta-tcsling in late October. like 
dropping a bigger engine into a hot rod, 
script execution instantly becomes much 
faster - in some cases up ro six time faster. 
With this boost in speed on PowerPC 
machines, Frontier is dosing the gap on C 
- offering both ease-of-use and excellent 
performance - while further increasing its 
lead on AppleScript. 

Despite the proven benefits of using 
Frontier to write CGI applications, many 
webmasters still are developing dieir CGIs 
in AppleScript, This inspired me to look a 
bit more closely at the differences 


between CGI applications written in Frontier and those in 
AppleScript, primarily focusing on performance issues. In this article I 
will share the results of some of my recreational [XTformance tusLing, 
and explain some of the different situatioas that affect performance. 
Since I am the author of the Frontier CGI Framework, a set of 
scripts that enhance CGI development in Frontier, you could 
understandably question my objectivity in doing such a comparison. 
On die oilier hand, since 1 have done a great deal of CGI development 
in both environments, I am also one of the lew people qualified to do 
such a comparison. In either case it is not my intent to discount 
AppleScript as a scripting environment. I think it is a great product and 
an important teclinology. 1 just don't Ixlieve it is well-suited to the 
specific task of CGI development. 


PERFORMANCE 

Performance is crucial to CGI applicatioas running on busy servers. 
The more processing time a request takes, the more likely a user is 
to give up and move on to another site. 

I've often been asked if Frontier is faster than AppleScript. The 
truth is, when comparing built-in verbs in AppleScript and die non¬ 
native version of Frontier, the performance is surprising similar. I 
ran a series of informal tests to compare the performance of 
AppleScript, non-native Frontier and native Frontier when running 
equivalent scripts. The scripts are based on the sample scripts from 
Frontier's object database. All tests were run on a Power Macintosh 
7200/75 with 16 MB RAM. Execution time is measured in licks 
(sixtieths of seconds). 

Tile first test script performs simple integer arithmetic using 
built-in commands in both the AppleScript and IJserTalk versions. 
The actual scripts are functionally identical. 

Test I: Arithmetk t AppleScript} 

set X to 0 * hi 

repeat vith i from 1 to iOOQ 


Mason Hale - Mason Hale is Director or Internet Services for VursaCom, Inc. - an Austin, Texas-based on line communications 
and Internet marketing firm He is the author of the Frontier CGI Framework and President of the Capitol Macintosh Users Group. 
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set I to X I (12 + 99 - 37 / 84> 
end 


Test I: Integer Arithmetic (UserTalk) 

tor i * S to iODO 

x - x + (12 4 99 - 3/ f 84) 

AppleScript took 111 ticks to complete the first test, while 
the non-native Frontier took 103 ticks. The PowerPC-native 
Frontier ran the same script in just 17 ticks. This First test really 
shows how close the non-native Frontier anti AppleScript were 
- and the tremendous difference the native version makes. 

The second test demonstrates the repeated calling of a 
Uxral subroutine. 


Tea 2: Sutmuifrinr (ill) (AppleScript) 

set y to 10 
on moof (x) 

return (x * 2) 
end 

repeal with 1 from 1 to 1000 
set y to moof (y) 
end 


Test 2: Sulittiulitic Oil (UsaTalk) 

y - 10 

on moo f (x) 

return U “ 2) 
tor i * J to 1000 
y » moot Ey) 

AppleScript blew die doors of the non-native Frontier in 
the second test coming in at 83 ticks to Frontier's 111 ticks. 
However, the PowerPC-native Frontier handily won with a time 
of 47 ticks. 

The third script compares the performance of commands 
from an external Scripting Addition to a built in Frontier vert). ! 
compared the speed of Frontier's built-in dock.now verb to the 
equivalent current date Scripting Addition. 

Test V Ruih-tn veri> vn Scripting Addition rthciTiiUO 

for 1 - 1 to 100 
y * clock.now () 


Test 1:1 Sm! tin verb vs. Strip ting Addition (AppleScript) 

repeal with I from I to 100 
net y to current date 
end repeat 

It tfxik AppleScript 113 ticks to complete tliis test, while 
the non native Frontier took J7 ticks and the native Frontier 
took 3 licks. Tliis illustrates a crucial point in determining the 
speed of a script. Built-in commands are faster than commands 
loaded from external axle fragments. Because AppleScript has 
few built-in verbs and relies heavily on Scripting Additions to 
extend the language, the use of external commands like 
“current date* is quite common. 

In the fourth example the script checks the existence of a 
file. Frontier uses a built-in verb 4 fiIe.exists rT , while AppleScript 
communicates with the scriptable Finder via AppIcEvcnts. 


Test I built-in verb vs. Apple Even I (AppleScript) 


mil application "Finder" 
repeat with i from l to 10 

if exists alias "Macintosh HlhSimpleText" then 
set x to x + 1 
end if 
end repeal: 
end teii 


, , . . Tcm 4: UuiJi-m vert^ v>. Apple Event (UscrTilk) 

local (x - 0) 

for t * t to 10 

if file.exists ("Mar Intosh HO:SimpleText") 
x++ 

Inter-application communication can really slow things 
down. Each cross-application Apple Event adds approximately 
1/1 second to die processing time of the script. Frontier suffers 
the same slowdowns when sending Apple Events to other 
applications, hut because more commands are available, 
external applications are relied on less often. 

The results of the fourth test bear this out. While the native 
and non-native Frontier applications finished in 3 ticks and 7 
licks respectively, AppleScript took 140 ticks to perform the 
same task using the scriptable Finder, 

My final test was “real world" example, based on the 
TesLcgi* sc ript that is distributed with MacHTTP This script 
uses no scripting additions and doesn't perform any cross- 
application communication. So it is a pretty good example of a 
common CGI script using built-in verbs. 


Test V Trsi CUt (AppleScript) 

property ctlf : {ASCII character 13) & (ASCII character to) 

rim binlits i he normal HTTP header tor ftguhir arctvs 

property http^lOJieadcr : "MTTP/t.fi 200 OK" 6 ertf b - 
"Server: HacHTTl'" b ctU b "MIME Version: 1.0* b ^ 
crlf b "Content-type: text/html" b crlf A rrlf 

on cgiScript (path.args, http_eearrh_urg[;, username, -* 
password, fron user. client address, aervemtiame. "■ 
server^port, script name, content type, reterer, ^ 
uset^age»t. anion, act ion path* post argm method* "• 
client_ip, fiill_requesH) 

i e y -wrap the whole >cript in an error handler 

return http_10Jieader b *<titIe>Tesi CGK/fitle>" A “» 
"<h2>Test CGl</h2><u>CCI arguments sent :<7u>" b -* 
"<br><b>paeh:</b> * 6 psth^args A "* 
w <br><b>seart:h:</h> M b http aearch.args b 
’ , <br><b>posi_iirg^:</b> w A posit args & * 1 
"<br><b>method:?/b> M b method b ^ 

,, Cbr><b>address:</!j> ” b cl Jem_address A ^ 
M <br><b>user:</b> h b username 4 "■ 

"(br><b>password s C/b> " b password b -» 

*<hrXb>frq»:</b> " 4 fron_user 4 “■ 
"<lirKb>servrr_naaie:</b> * b server, name b 
l4 <br><b>server_port :</b> * b server port b ’ 
"<br><b>script_na»e:</b> • & aerlpr name b 
"<br><b>reterer:</b> * 4 referer 8 
*<br><b>user agent:</b> * A user_a&om A 
"<brXb>content type:</b> * b contem_iype 4 rrlf 
on error msg number nild 

re Urn hUp_lO_Jwwder b "Error " b nuns 4 ", * b mag 
end try 
end caller 

repeat with i frost 1 to 10 

egI Script (*aaa". "bbb", "ecc", "ddd". "eee", 

"fff"* "ggg". *hhb*\ "iii", *kkk". - 

*Ur\ "nnn*. "ono*. "ppp". "qqq", "rrr") 

end repeat 
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Test 5: Test CXit (UsoTaDt) 

on cgiScript (pathArgs. httpSearehAxgs T username, \ 
password, troiaUser. clientAddress, serverKame. \ 
serverFprt* scriptName. contentType, referer* \ 
userAgent, action, actionPath, pontArgs H method, \ 
clientlp, ful Utequest 3 

try 

return (Webserver.httpHeader [) + \ 

f, <title>Test CGI</titUXb2>Test CGl</h2X h \ 

"<u>CCl arguments sent;</u>" + \ 
r <br><b>path ;</b> " J pathArgn + \ 

N <brXb>search;</h> " + httpSearcHArgs + \ 

"<br)<b>pnflT. ,irgn:</b> * + pustArgs + \ 
# <f)r><b>mctho(I:7/b> M + method + V 
- <lirXb>atldtesa:</b> " + client Address + \ 
"<brXb>user;</b> " + username + \ 

"<brXb>psssword:</b> " + password 1 \ 

- <brXb>froittl</b> " * fromlfser t \ 

*<br><b>server name:C/b> * 4 nerverNunte + \ 
*<br><b>server port:</b> “ + sorverFort + \ 
*(br><b)scrlpt_nafto:</b> " + scriptName + \ 
*<hrXb>refctet X/b) " + referer + \ 
rt <br><b)user agent:</b> * + userAgent + \ 

"<br><b>content_type:</b> " + contentType » cr t if) 

else 

return EvebServer.htipHeader () f "Error * + UyErrur) 

local Ci) 
for i * ] to 10 

cgiScript ("ada", *bbb*, *ccc fl . "ddd", "ggg“t \ 

n hbh *, nil"* "jjj". "kkk* * "111". *mB" ( w nnn\ "ooo*. \ 
,f ppp # t "qqq". "rrr*j 

As expected, the AppleScript and non-native version of 
Frontier performed similarly. The AppleScript CGI test finished 
in 69 ticks, heating out Frontier at 74 ticks. Native Frontier won 
again with 14 ticks. A summary of the timing results fur all llvsls 
is shown in Table 1, 



AppleScript 

Frontier 68K 

Frontier PPC 

Integer Arithmetic 

111 

103 

17 

Subroutine Call 

H3 

272 

43 

Built-in vs. OS AX 

113 

17 

3 

Built-in vs. AK 

14(1 

7 

3 

Tesi CGI 

ft) 

74 

i i 


Table L Camfutrison of execution times (all times in 1/60 second) 

Multithreading 

Beyond straight script execution, another factor can 
significantly affect the speed at which a given script runs: multi¬ 
threading. in the exponentially-growing world of the internet, 
it is common for the average web server to receives thousands 
of requests a day. It is also quite likely that two clients will 
request die exact same file at the exact same time. If the 
requested file happens to be your CGI script, it will have to 
deal with two concurrent requests, 

AppleScript is not multi-threaded, and handles multiple 
concurrent requests by placing them into a queue. 
Unfortunately, AppleScript processes events on a last-in first-our 
basis - so the latest event received is the first to be processed. 
To put it another way, on a very busy server, the first person to 
call the CGI may very well be the last person to receive the 
results. This can resuli in every single request timing out if new 
requests keep forcing older ones further back in the queue. 

Frontier is fully multithreaded. Every new request spawns 


Your web site better than the other 100,000 ? 


IT CAN BE WITH THESE NEW TOOLS ! 




Call Now! 607.255.2067 
email: product-info @ webgenesis.com 

Cheek them out at our entertainment site: THK GLOBE 


Add exciting interactivity to your 
Mac web site with registration* 
surveys and real-time chatting! 


ORDER 

ONLINE 

NOW! 


http://www.webgenesis.com 


a new thread aiitomalically. This means that incoming event 
art 1 processed immediately and do not prevent processing of 
earlier requests, 

A more subtle, hut still important performance consideration 
is the fact that all Frontier-based CGI's are 1 hosted by a single 
application. In the cooperative multi-tasking Mac OS, applications 
must imperatively share processing time. Adding a new, separate 
application for each CGI creates more overhead to manage the 
sharing of processor time among the competing applications and 
eventually slows down all the applieaiions. Consolidating all CGI 
scripts into Frontier's object database eliminates this overhead. 

Conclusion 

Being PowerPC-native and mull it handed dearly gives Frontier the 
performance advantage over AppleScript. However, even if 
AppleScript were multi threaded and native, its reliance on 
Scripting Additions and external applications to perform its 
functions severely limit performance, and thus limit its usefulness 
as a development environment for CGI applications. 

URL’s 

Native Frontier Public Beta release: http;//wvwv,hotwired com/ 
use rl an d/ya bbad a bba/n ati vef rontierp u b I i cbe_ 390. h tm I 
Frontier CGI Scripting: http ://www,we hedge, com /frontier/ ^ 

Aretha Website: http;//www,hotwired,com/userland la retha/ ^ 
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Microsoft Corporation 
One Microsoft Way 
Redmond, WA 98052-6399 


Id 206882 8080 
Telex 160520 
Fax 2069367329 


Gentlepersons, 


Microsoft 


Thank you for the support that you have shown to cross-platform development in the last 
year. 

It was a fun year for me, as Microsoft’s evangelist to the Macintosh software development 
community. From the popular free seminars on “Windows 95 Programming for Mac 
Developers” at last January’s MacWorld Expo, through MacHack, and on-line, I have 
enjoyed working with Mac developers in their explorations of Windows 95 and Windows 
NT. 

During that time, cross-platform support from previously Mac-only software companies 
has increased dramatically, with new releases of Object Master and 4 lh Dimension for 
ACTUS, ClarisDraw and ClarisWorks from Claris, Ray Dream Designer from Ray Dream, 
KPT Convolver from HSC, MacFlow from Mainstay, SimTown from Maxis, Metrowerks’ 
CodeWarrior 7 x86-targeting cross-compiler, Route 66 from Route 66, and many, many 
others. In case no one has said it yet: thanks! Your applications make Windows better, 
and I am grateful for your support. 


At the same time, Microsoft is helping previously Windows-only software developers 
move their applications to the Macintosh - and make cross-platform development easier 
for everyone - with our recently-released Visual C++ 4.0 Cross-Development Edition for 
the Macintosh and Power Macintosh. 


This cross-platform support improves the experience of end-users, who can now use their 
favorite applications on the platform of their choice. Hopefully Microsoft, Apple, and our 
mutual third-party developers will continue to find new and innovative ways to work 
together to improve the end-user experience. 

Tn all of this, 1 have enjoyed the friendship and camaraderie of a significant part of the 
Macintosh development community, and for that, especially, I thank you. 

Looking forward to another great year of helping cross-platform developers, 1 remain 


Yours, 



Microsoft Developer Relations Group 


P.S.: If you’d like to investigate supporting Windows in addition to the Mac, please check 
out Microsoft’s Web site: http://www.microsoft.com. 


Microsoft Corporation is an equal opportunity employer. 












By John R Powers. ///, & tide Works, LLC 
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New Apple Guide Authoring Aids 


Three books and 
accompanying software 
for Apple Guide authoring 


Apple Guide Complete: Designing and 
Developing Onscreen Assistance 
By Apple Computer* Inc. 
Addison-Weslcy (0-201 -48331-3) 
$39.95. 354 pages. 

Real World Apple Guide 
By Jesse Feller 
M&T Books (1-55831-429-5) 
$39-95. 411 pages. 

Danny Goodman s Apple Guide 
Starter Kit 

By Danny Gcxxlnmn and 
Jeremy Joan Ilewes 
Addison-Wesley (0-20148349-1) 
$34.95. 295 pages. 

Appk. Guide authoring just got a lot 
easier. Three new books and accom¬ 
panying software make it that way. If 
you already know about Apple Guide, 
skip u> the next section. Otherwise* 
hang on and i’ll give you a quick 
introduction. [For more on Apple 
Guide, see the March and July '95 
MacTeeb Magazine. I 

Introducing Appi f Guide 

Apple Guide is the exciting help system 
that comes with System 7.5- It enables 
users to accomplish tasks with minimal 
directions* It actively leads users 


through the steps required to complete desired tasks. For 
example, let’s pretend you make fax .software. You may use 
Apple Guide to lead your user through the steps to send a fax, 
including how u> set up ihe address, cover page* and 
scheduling transmission. You do this by creating a guide file 
dial Interacts with the user step-by-step. The guide file checks 
the user's context anti presents only the necessary information. 
It also automates many of the steps via AppleScript, and uses 
Apple Guide's unique “coach marks" to highlight live interface 
elements so that users can simply poim-and-click their way 
through the process. Your users are happier and your customer 
support line is less busy. 

Willi the recent release of version 2.0, Apple Guide 
technology is available from System 7.0 on up; and it wall be a 
key part of Active Assistance in Copland. More and more 
applications are including guide hies. Third party developers 
like die way it gives them a competitive advantage and reduces 
the load on customer support. Major corporate users like how 
it streamlines the work flow and how it reduces the loud on the 
help desk. 


Authoring Apple Guide 

One authors Apple Guide by combining content and 
instructions into a guide file. The current guide authoring tools 
are Guide Maker , Guide Composer * and Danny Goodman's 
Apple Guide Starter Kit . 

Guide Maker is the original Apple Guide authoring tool 
developed by Apple. U s five tools in one: build guide files, 
test look-for, diagnose guides* convert WinHclp, and 
impon/cxpori for localization. Guide Maker uses Guide Script 
as its means for ^programming" guide files. Guide Script is a 
mark-up language; the author writes the guide content and lags 
the content with Guide Script. There are about 100 commands 
that control startup parameters, formats, sorting, sequences* and 
much more. 

Guide Composer and Danny Goodman's Apple Guide 
Starter Kit (the latter included w ith his book* discussed in this 
article) are two new tools that provide a WYSIWYG interface to 
guide authoring. Both of them output Guide Script for 
automatic compilation by Guide Maker Lite* a special version of 
Guide Maker without a user interface. 
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Power Mac and 
Macintosh 
Developers 




FIND OUT FAST 
WHAT'S GOING ON 
IN MEMORY 


THE MEMORY MINE 


■* See memory allocation in any open heap at a glance. 

^ Easily spot memory leaks, 

* Flags heap corruption when it happens. 

Works with source level debugger to let you find memory problems fast, 

«► Stress applications on the fly with Purge, Compact, and Zap, 

Allocate memory at will tor precise stress testing. 

Log heap data * easily document heap status over time. 

No need for source code: nothing inserted in code: no patches 
to the system, 

^ Works with 24-bit, 32-bit. and modem memory managers. 

Far MacinlmJwr. with GftQSQ or tjr-McT Requires System 7 0 or taler 

only $99 US 

Order now from Adianta, Inc. 

Phone 1415)781-8052 • FAX: (415)781-8053 
AppleUnk:ADIANTA* AOLrAdianta * lnierrtet:adiania@aol.corn 

For VISA, MC. ot American Express orders toy mail, fax, or Apptelmk please include 
name, address, card number. expiration date, and phone number or emaO address 
Also available through the MacTeeh Mail Order Store and AFDA 
tor more inlormalton contact 

Sf Adianta, Inc. * 582 Market SUY911 * San Fnmcbco, CA941D4 


Apple Guide 

Put the power of the leading 
on-screen help system to work lor you 


New Authoring Aim 

llic new txxiks and accompanying software are: 

Apple Guide Complete; Designing and Developing 
Onscreen Assistance 

This is Apple's own Apple Guide hook, written by Apple's 
Developer Press. Think of it as the Apple Guide Inside Mac , 
2nd Edition, for guide authors. It provides authoring tips and 
suggestions, describes how to use Guide Maker and Guide 
Script, and documents the Apple Guide API. 

Apple Guide Complete includes a CD-ROM with lots of 
Apple Guide material, including Apple Guide, Guide Maker, 
sample guide files, sample source files, sample context checks, 
the Apple Guide interface files ami libraries, and a searchable 
command reference to all Guide Script commands. The CD- 
ROM dc>es not contain the latest release of Apple Guide (2.0), 
Guide Maker (1.2,7), or Guide Maker Lite (1.2*5); those you'll 
have ro ger from Apple’s ftp site. Apple's Developer CD, or the 
Mac OS SDK. 

Heal World Apple Guide 

This book covers much of the same material as in Apple 
Guide Complete, but with an emphasis on actually using Apple 
Guide to solve problems. Think of it as Jesse’s Handy Guide to 
Using Apple Guide, ll contains the prerequisite chapters on 
Apple Guide, Guide Maker, Guide Script, and the API, but also 
includes chapters on creating guide files for use with common 
frameworks and applications. For example, it describes how to 
add Apple Guide to MacApp and 4th Dimension, 

An accompanying CD-ROM includes Apple Guide, Guide 
Maker, and related files, it also includes lots of demos, and a 
cookbook which comprises shells, guide script examples* and 
code examples. Like Apple Guide Complete, the CD-ROM does 
not contain the latest releases. 


We provide a full range of services to help you use 

this new technology most effectively. 

•Contract guide file development - give us your 
requirements and we will work with you to determine 
the best uses of Apple Guide in your application. 

•Development sendees « we can provide instructional 
design, content, scripting, and custom engineering 
to speed up your guide file development. 

• Technology transfer and training - we will help your 
staff develop Apple Guide expertise* 

Telephone: 408-3954158 

COtttaCt Inlernet: pawers@guide works, com 

WWW: http://www.guLdewarks.com 


Danny Goodman $ Apple Guide Starter Kit 

'Fills book takes a completely different approach from the 
other two. Danny starts the reader immediately authoring guide 
flies using his Starter Kit software. It’s a very “hands on" 
approach that quickly produces a guide file from Danny's 
WYSIWYG interface. Once you learn how lo use die authoring 
too], Danny and his co-audtor, Jeremy I (ewes, introduce design 
concepts and advanced topics. 

Tlie book includes a floppy disk with the Guide Starter 
software. Guide Maker Lite, a sample application, and support 
files. Apple Guide and Guide Maker are not included, nor are 
they necessary since Apple Guide is in System 7.5 and Guide 
Maker Lite is the only compiler Danny's software needs. 


Works 


~ Intelligent Assistance Solutions 


guMeWorks, LLC 16373 Alexander Amue Monte Sereno CA 95030 


Comparisons 

Well attempt to help you sort out the possibilities by providing 
a couple of different ways lo compare die books. 
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Who is the reader? 

Third party developers use Apple Guide create guides for 
lheir applications. All three books cover this. 

Solution providers use Apple Guide to develop custom 
guides for end users. While ways to do this can be inferred 
from any of the three books, only Real World Apple Guide 
includes specific information on creating guides for common 
third party applications and frameworks. 

Application .software engineers need information on how to 
support Apple Guide within their applications. Apple Guide 
Complete and Real World Apple Guide provide API 
documentation for this. 

How well do they support the development process? 

Creating Apple Guide files requires a seven-step process: 
task analysis, instructional and visual design, writing content, 
scripting, application integration, testing, and localization. Lcfs 
examine how each book supports each step in the development 
process. 

• Task analysis: identifying and articulating the tasks that the 
user must accomplish. This is a very difficult step, but 
essential for Apple Guide's task-oriented design. 
Conclusion: zip for all three. None of the books provide 
help in this essential area, 

• Instructional and visual design: specifying how the 
guide will support the user's tasks. Conclusion: all three 
books provide good coverage of this area. Apple Guide 
Complete provides the most information on design, 

• Writing content: creating the words and images to support 
the instructional and visual design. Also includes all the 
indexing of the guide topics for the Apple Guide's search 
engine. Conclusion: Apple Guide Complete and Danny 
Goodman's book provide information on this area, Apple 
Guide Complete also covers the difficult area of indexing. 

• Scripting: wrapping the Guide Script around the content, 
This includes all the sequencing of steps, context checking, 
and automation. Conclusion; All three books provide ample 
coverage of this difficult step in the process. None of the 
books cover automation scripting using AppleScript, though. 

• Application Integration: Apple Guide does not require 
that the application it supports be changed in any way, but 
if you can change it, you can really improve the user 
interaction. Application integration adds code to the 
application to support the guide. Conclusion: Apple Guide 
Complete and Real World Apple Guide provide reference 
material for application integration. Real World Apple Guide 
also provides detailed integration information for MacApp. 

• Testing: guide fries must be tested like any other complex 
softwa re. Concl us ion: Apple Git ide Complete prt > v i dcs a litii e 
information. 

• Localization: guide files, like the applications they support, 
must serve an international market. The guide content must 
be localized. Conclusion: Apple Guide Complete provides a 
little information. 


Superior 
Copy Protection 

* MACi/ock makes you money 

* MAC/fock is SAFE, TRANSPARENT & EASY 

* MACf/ock is aggressively priced 

* MAC/fock works on Macs & Power PC’s 

* NETIfock provides LAN license control 

+ Broad Prod urt Range includes PARMock (PC) 

Spending $25+ for copy protection should get you more than a pretty dongle. 
Please let us explain why M AC/Jock’s micro processor is superior to old 
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800 - 909-3141 


EAGLE DATA 
PROTECTION 


On CompuServe GO PIRACY 

350S4DOEa&lStolDi ft Salt Ufeft City. Utah 84111 ft Tal 8D1-383-73M fax #001-536-0200 



MultiQuest S-CASE 



The Clear Choice for 
Serious C++ Architects 


Take control of your C++ divdopnurni with S-CASL, a powerful design environment 
for today s demanding applications Visualize system requirements u>ing the Bunch 
nniatirai. Generate fo + aide automatically from your design. Keep your model* and 
code in perfect synchronization, Call for ynur free demo disk and find out why com¬ 
panies like Motorola, Airmens nnri Amoen roly m S-CASUt. 


Key Features: 

■ Booth notation (1994) 

* Beal lime rule cheeking 

* Iterative C+ + fiodfi generation 

* Hiomrnhical prnjocl manager 

* Multi-user 

* Multi-platform 

- Check In t check out 

* Color support 


Benefits: 

* Rapid prototyping 

- Cleaner archi lectures 
+ Reusable designs 
Platforms: 

- Macintosh 

- Windows 

- Sun SPARC 

* HP fHWN) 
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Presenting the extra-strength text editor. 



If you thought previous versions of QUED/M 
were powerful, wait until you program with 
QUED/M 2.7, loaded with these new pain- 
relieving features: 

sb* Integrated support for THINK Project 
Manager* 6.0 & ZO 

^ MINK 1 * debugger support 

CodeWarrior " support (now it's 
easier than ever to program for the 
Power Macintosh®!) 

MPW ToolServer* support 
PopUp Fun cs™ support 
Frontier" Do Script support 

For quick relief, call 
800-309-0355 today. 


Of course, QUED/M 2.7 still has all the features 
that make it easier to use than any other text editor: 

Macro Language lets you automate 
tedious tasks 

Search and Replace through multiple 
unopened files and using GREP 
metacharacters 

^ File comparisons using GNU Di ff 
Unlimited undos and redos 

10C lipboards that can be edited, sa ved, 
and printed 

Customizable menu keys 
o> Text folding 
e=s> Display text as ASCII codes 
m> Plus many more features! 


Get even more relief: Try QUED/M 2.7 now for just $69! You’ll get a 
30-day money back guarantee too! Call now to order. 800-309-0355. 


is a tf IVi^w Gmaf&v Jur. dlf niter [mitxte 

ijK twhtmtx** ngefemri tmJtrnufist. dUtefr mpxttw 
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NISUS 
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POFILE 


PowerPlant 

integrated closer than any other database 

AppMaker 

complete database application generation 


HTML 


report-writer built into database 


No Stream Methods 
No Preprocessor 
No Fuss 

dcnt@highwayl .com.au 
CompuServe: 100033,3241 
http: //www. high way 1 .coni.au/adsoft ware/ 

demo’s on CodeWarriur & AppMaker CD's 
royalty-free, full source, priced from $900 inc. c-tree 


the cross-platform OODBHS that speaks C+ + ™ 


What do I buy? 

All three books are helpful for guide authoring. If you 
have to pick just one, consider the following: For a 
comprehensive reference, pick Apple Guide Complete. For 
custom solutions and practical applications, pick Real World 
Apple Guide, For a fast sum. pick Danny Goodmans Apple 
Guide Starter Kit. 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

productinfo@xplain.com 
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NEW 

APPLE 

TECHNOLOGY 


By Eric Soldan, Apple Developer Technical Support 



OpenDoc: Contain Yourself... 


Updating applications to 
work with OpenDoc 


It’s time to be an Open Dot'™ container 
application. It's nor too soon, and it's 
not too late. So how do you decide if 
your application should lie an OpenDoc 
container application or not? Here’s an 
easy test: 

* Will your application benefit from 
Internet access? 

If the answer is yes, then Ireing an 
OpenDoc container application is 
probably the right tiling to do. By 
becoming an OpenDoc container 
application, you automatically get the 
benefits of every tiling that is OpenDoc, 
including CybeiDog, which will provide 
component oriented Internet clients and 
other Internet services. Now is not the 
time to ignore the Internet bandwagon. 
It's worth jumping on. The only 
question remaining is how to jump. Do 
you learn Open Transport and MacTCP 
and recode your entire application to 
support the Internet? Or do you look for 
alternatives, like OpenDoc? 

A logical question therefore would 


be: “Is OpenDoc really the fastest way to add Internet Lo your 
application? 1 * Adding Internet support with OpenDoc boils 
down Lo adding basic OpenDoc support; in this article we will 
evaluate the difficulty of adding OpenDoc Lo an existing 
application. Ihen you can decide. 

The Container Application Library; Your Friend. 

CALih, the Container Application library, lias been evolving for 
a while. It's looking really good right now, Joshua Sussex of 
OpenDoc engineering, and I have licen adding CALib support 
to an application 1 originally developed in Developer Tech 
Support called DTS.Draw. I wrote DTS.Draw years ago, 
without ever considering the possibility of adding something 
like OpenDoc later. DTS. Draw's document model, while 
flexible, is a closed model, so adding OpenDoc support is 
therefore a very interesting lest case for CALib. 

It turns out that the amount of additional coding necessary 
is minimal. However, due to CALilTs flexibility, there were 
many development issues that had to be discussed for quite a 
while. If these discussions were not held, the implementation 
would not have l>een as robust. I will present what we’ve 
learned from these discussions. 

First, lei's talk alx>uL DTS.Draw for a while. When adding 
OpenDoc, ifs important to understand how the existing 
application works. Since you are probably not familiar with 
DTS.Draw, Fll give you a quick overview. 

DTS.Draw is an AppsToGo framework based application. 
AppsToGo is an object-oriented C framework written by 1)TS. 
DTS.Draw is also all C code. DTS.Draw is a “standard” drawing 
application. It has a tool palette of a variety of drawing objects. 
It has a hierarchical document architecture which allows for 
grouping and ungrouping of draw objects. It supports infinite 
undo. It supports drag and drop. 


Eric SaUtan - Eric Soldan is a seven year veteran in Apple DTS and an Apple short-timer Once this is done, he’ll turn in Ins 
badge and start his new life as a developer person. Yep - he’s doing the startup tiling, (Yawn..,) His new company is railed 
6prime. (You may have already seen him quoted on the 11/6 cover or MacWeek as president of 6prime, And no, lie didn't 
get a mug for the infoj dprime will specialise in OpenDoc development and Windows-toMac porting. 
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Optimizing compiler for 68K 

AND POWERMAC 

COMPLETE PROGRAMMING 
ENVIRONMENT WITH OVER tOOMB 
OF TOOLS AND DOCUMENTATION 

o^> 

SOURCE LEVEL DEBUGGERS 

1 aiii 

Visual interface generator 

SOURCE CODE GENERATOR 

Plus 

NATIVE PORTING KIT FOR 

MacApp 2.0! 

Ov 

Coming Soon! Support for 
Symantec Project 
Manager 8.0! 


CALL OR WRITE FOR MORE INFO: 

1-800-252-6479 
1-703-689-9593 fax 
Language Systems Corp. 

100 Carpenter Dr. Sterling VA 20164 
http://www.langsys.com/langsys 


When a document is saved, the object hierarchy is flattened 
anti streamed to the file. When a drag-out occurs, die selected 
objects are streamed into a handle; this stream represents a sub* 
hierarchy of the document. This sub-hierarchy is Lhen just a 
flavor for the dippings file. When a file is opened (or a drag-in 
occurs), the hierarchy is reconstructed. Very standard stuff. 

Here's a diagram of a representative DTS.Draw document: 



For a save, the objects in the hierarchy are streamed in 
simple tree-walk order, as indicated by the numbering. The 
drag objects 2, 4, 5, and 6 can lx* any supported object. The 
current implementation of DTS.Draw allows for line, recr, round 
reel, oval, and pie objects. More can be added of course, and 
this exactly is how we added OpenDoc support to DTS.Draw; 
we just added a new OpenDoc Part object into the application. 
The difference with this object is that the content isn't anything 
specifically manipulated by DTS.Draw, It is simply a part the 
user adds lo the document. The DTS.Draw object just serves as 
a “container" for the OpenDoc part. If a user were to add two 
OpenDoc parts to the above DTS.Draw document, the 
document hierarchy might end up looking something like: 



'Hie implementation in DTS.Draw is relatively simple. The 
Pan object inherits from DTS.Draw's native red object. Hie 
difference is that it has a much more complex content that the 
reet object in the standard DTS.Draw application. The content 
of the Pan object can be any OpenDoc part, of course. The 
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content of the Part object i$ managed using CALib. Given tills 
information, look at this diagram and see exactly what the 
relationship between the Part objects and CALib : 



As shown above, there's a lot more to the DTS.Draw 
document now. Fortunately, mast of the new stuff is managed by 
CAUb and OpenDoc. CALili uses a "proxy part" to contain the 
parts that are placed into the document content. Normally, 
OpenDoc expeti.s there to l>e a root part that is an OpenDoc 1 2 
container, but since other parts are "embedded" into your 
application’s non-OpenDoe document, a proxy container j>art is 
created and the "embedded" parts sue stored in there. Hie proxy 
part, as far as OpenDoc is concerned, Is what actually contains the 
other parts that are referenced from the DTS.Draw native content, 
Ihe difficulty here is that the proxy part isn’t Teal" It has 
no geometry information, and OpenDoc doesn’t automatically 
bind the proxy part to any code, as is the normal case with 
OpenDoc parts. Thus. OpenDtx: is unable to offer the full range 
of services for the embedded parts. But this is okay, The proxy 
part Isn’t all that smart, nor should it be* It is simply a part that is 
used by CALib to have somewhere to put the other parts. 

So it's up to DTS.Draw to control the layout and 
presentation lor the OpenDoc pans. Only the application 
knows the geometry information for the embedded parts, 
which is stored in DTS.Draw Part objects. The DTS.Draw Part 
object also has a persistent reference to the corresponding 
object embedded in the proxy part. Fortunately, CALib offers 
API calls to help manage these and other OpenDoc 
interactions, so Lite above and other OpenDoc related tasks are 
relatively simple to implement. 

For example, to perform screen updates and such, 
DTS.Draw simply tells CALib to tell the part to draw itself. All 
that is needed is the Pan Kef value, which Indicates to CALib 
which embedded part to draw. The application doesn’t have to 
care what it references. It references something, and that thing 
knows how to draw itself. 

Streaming Your Objects 

Given that die proxy part can’t realty deal with containing parts 
by itself, (Le., without vour application doing the geometry), 
the proxy pari and its cmlxaJded parts do not constitute a valid 
OpenDoc document. This is important when we decide what 
type of document you want to create when you save it to disk. 
The choices are: 


CetAhead 



Meel Charlie. Charlie likes to program. But Charlie hales haring, repetitive code, so 
he created Open Dialog'* OpenOialog is "everything the Dialog Manager should've 
been," Use Charlie s head for dialogs and save your head (and your hairJ for real 
problems A set of libraries that replace I be Dialog Manager, Open Dialog will 


Simplify creutian of malli panel 
items, such as preference dialogs. 
Relieve you of silly chores, like 
managing radio butlarcs. 

Provide you with "no-resource" 
dialogs lor alerts & progress bars. 


Easily integrate into existing code. 
Cost only S259 (source code license 
available). 

Keep you from going bald. (Charlie 
lost his hair before OpenDiolog.) 


FGM Inc • 703.470.9081 * hrrp://www.fgm.cofn * tmoif: flftndtg42@fgm.com 


1, A Bento stream placed inside your document. 

2, Your document stream placed inside a Bento document. 

The right choice will of course depend on your application. 
For DTS.Draw p we chose 1. Choice i is closer to existing 
Macintosh applications. Choice 2 is closer to regular OpenDoc 
parts. If you were to consider the development choices, from 
application to OpenDoc part, with CALib applications 
somewhere in between, your choices look something like this: 

Application: 

Standard document architecture. 

CALib-friendly application: 

Standard document architecture with embedded Bento 
si ream. 


CALfb-sawy application: 

Bento document with application data streamed into an 
OpenDoc storage unit value, 

OpenDoc part editor: 

Bento document with part editor data residing in an 
OpenDoc storage unit. 
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BUILD UPDATERS 
WITHOUT PROGRAMMING! 


PatctiNorHs Pro 

PatcbWorks Pro lias many options, but only one function: to 
create small, stand-alone Updater Applications which field* 
upgrade your products to newer versions, Updaters can be 
freely and safely distributed online, since they are only of use to 
end-users who've already purchased your software 

UPDATERS ARE FAST, 

SAFE & EASY FOR END-USERS 

Your end-user just downloads and runs the Updater. The 
Updater prompts the user for the original software via a "Get 
File” dialog box {if not in the same folder as the Updater), 

When the user dicks the "Update" button, the original software 
is updated immediately 



UPDATERS ARE CREATED IN MINUTES! 

Why tie-up valuable programming time building updater 
applications? Just fill in a dialog, and PatchWorics docs the rest! 
Since there's no coding or scripting, no bugs are introduced, 

* Works with apps, INTTs, edm, fonts, drivers, etc. 

* Works on resource and/or tlata forks 

* Full support for PowerPC and Pat binaries 

* Updaters support multiple "old versions" 

* Preserves personalization data (name, .serial #, etc.) 

* Customizable end-user interface 

* Updaters can execute custom COOK resources 

* Intelligent diff-ing produces small Updaters 

* Distribution of Updaters is unrestricted and royalty-free! 

NOW AN INDUSTRY STANDARD 
AFTER FOUR YEARS ON THE MARKET 

PatchWorks Pro is used by Macintosh publishers such as: 

Apple Computer, Adobe Systems, MacroMind, Now Software, 
Symantec, WordPerfect, and many more* Pricing begins at JI95- 
Download a fuDy-functional trial version from our web site: 
"hUpy/www.broadcasrsoft.com^ or call us at (407) 241-0308. 


Broadcast Software Corp 

Ease 407-241-0308, Fax: 407-241 3195 
West: 503-317-0429, Fax: 503-317^0430 
Net: hi i p/Avwbrcmlostsoft com 
Email: info@l)nw< icastsoft.com 


Broadcast 


When considering drag and drop, the above categories are 
very important. When applications drag something to the 
desktop, a dippings file is created. When OpenDoc parts are 
dragged to the desktop, an Open Doc document is created, 
instead of a dippings file* This is an important distinction 
between applications and Open Doc. Applications create 
clippings files because they are a standard and flexible 
intermediate format, OpenDoc parts create OpenDoc 
documents on a drag-out because art OpenDoc document is 
already a universal format, There's no reason to resort to 
creating a dippings file. 

If you are a CALib application, ihc choice is no longer so 
clear* Our suggestion is to base your drag-out decision on 
whether your document format is still u native," or if you use a 
Bento file with your native content embedded. 

So, if you are a CALib application, what is one to do on a 
drag-out? The answer lies in the document type. If the 
document type is an OpenDoc document (CAUb-savvy), then 
the drag-out type is OpenDoc document If the document type 
is a standard document (CAUb-friendly), then the drag-out type 
is a dippings file. 

DTSDraw’s native content is simply streamed out* After 
adding CALib support, this is still the case. The Bento document 
is streamed out, as well. Here’s the new document format: 


Byte offset 

0 to 3: 

4 to nativeContent - 1: 
nativeContent to LOF: 


Description 

length of Bento stream 
Bento stream 

native content stream, i.e*, 
DTSDraw old format 


There was mudi discussion as to whether or not the Bento 
stream should be at the front of the file or the end. It turns out 
that you can do some interesting things if it is at the front of the 
file. Try out this situation: 

1, Your machine has CALib, You add some OpenDoc parts to 
your DTS.Draw document. 

2. You then send the document to some poor individual who 
doesn’t have CALib or OpenDoc. 

Guess what? If the Bento stream is in the front of the file, 
the unfortunate individual can still use the file with your CALilv 
friendly application. The user without CALib can actually edit 
the native content and save it out. The native content changes 
size, but hey, it's on the end of the file* 

On machines that don't have CALib but need to display 
Part objects in their content, the standard look tor "NoPart" 
should be used. This is what OpenDoc displays when an editor 
for a particular part isn’t available. In the case of CALib 
applications, it works for when CALib isn't available, as well* 
Making your CALib-based documents work on machines 
with or without CALib takes a bit of extra coding, but from a 
version control standpoint, it is well worth it. Documents can 
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gu anywhere. A CAUb document can tx* given !o someone 
without CAUb, That this person can actually edit die native 
content of the document, and then give the document back to 
you, is pretty nifty. 

On machines where CAUb isn't available, users obviously 
won't lie able u» add any new parts to die document. They w ill 
lx* restricted to editing the native content. However, this may 
include moving parr objects around that someone else was nice 
enough to put in the document. This works. Remember that 
the geometry information is stored in the native objects, which 
all users can edit. The proxy part doesn't handle the geometry. 
In addition, the user can delete the Pan objects (which arc 
displayed using die u No Part" look). This of course means that 
there is data orphaned in the Bento stream, (Since the user 
doesn't have CAUb, there is no way their machine can modify 
the Bento stream,) Fortunately, the stream will be compacted 
the next time the document is saved on a machine with CAUb, 

With some extra work, you can even allow die user to 
resize the Part objects without CAUb. When this occurs, the 
information in the Bento stream for that part is no longer up to 
date, rite native content object will need to be Bagged as 
having been resized. When the document is opened on a 
machine with CALib, these objects will need to have their frame 
information renegotiated and resolved to reflect their new size. 

We've been discussing types of editing that can sLilt occur to 
a CALib document Part object when CAUb isn't available. There 
are, of course, edits that can't lx* performed. Here are two: 

1. Dragging that includes a Part object. Streaming the drag 
data must include streaming the Bento information Into the 
flavor This can't lx* done without CAUb. All that’s in the 
native object is a [xrslslent reference to somewhere inside 
the Bento stream. You can't resolve the reference without 
CALib. 


2. Copying the object. At first, it would seem that you would 
just copy the native content object* It has a persistent 
reference. Both copies of the object would then |x>int to the 
same Bento information, i.e., the part. This is a had thing. 
When opened again on a CAUb machine, each copy of the 
part should be Independent of the oilier, (You could Hag die 
copy as an unresolved copy, and then done the object when 
the document is next opened on a CALib machine.) 


As you can see from this discussion, CALib can be used to 
add OpenDoc capability to your existing applications without 
radically changing the way they work* 'Hie actual amount of 
code added to an application isn't all that bud, either. Of course, 
this will vary, depending on architecture and document content, 
but most likely, it's not a complete recode with major 
mixiifieaLioas throughout your application. Look for the latest 
CAUb and CASample sample code on the OpenDoc DIO release. 

Have fun out there! ^ 


SOLID SOLUTION FOR 
ELECTRONIC DISTRIBUTION 


Broadcast 

Broadcast is a highly secure, patent-pending system for safdv 
distributing “locked" software online, or on CD-ROM litis 
cutting-edge technology was developed by the same 
engineering team behind PutchWorks—our tool for creating 
online updaters that’s become an industry standard used by 
clients like Apple Computer, Adobe Systems, MaemMind, Now 

Software, 


Symantec, 

and 

WordPerfect, 



BROADCAST IS EASY 
FOR YOU A1UD YOUR CUSTOMERS 

In seconds, Broadcast securely locks your product into an 
Lfnlockcr application that can he safely distributed to the 
public. To buy your product, customers simply run the 
Unlocker— then either call you, or complete an onscreen order 
form that's emailed or faxed to you with a unique "control 
number" (and encrypted credit cart! data). 

Your stalT processes the credit card, registers your new user, 
and provides your customer with a password basal upon the 
control number. To unlock your software, the customer enters 
this password in the Unlocker 

BROADCAST IS INEXPENSIVE 

We aren’t resellers or distributors. Customers buy directly from 
you, and we take no percentage of your sales— just a small fee 
per transaction. In fact, Broadcast is distributed for free, We’re 
bating you'll quickly use the free password points that come 
with Broadcast, and purchase more as your sales soar 

Well even help attract customers by advertising your products 
for free on our "Software Unboxed" internet mall. 

GET THE WHOLE STORY 

We invite you to Irani more by visiting our interna web site at 
"h t ip:// www, broadcast soft .com ”, and download your free 
Broadcast Starter Kit, or email us: t, info@broadt’asisoft,com". 


Broadcast 


Broadcast Software Corp 

List, 407-24 l-m Fax: 407-241-3195 
West S05-3174429, Fax; 503-3174430 
Net: hup;//wwwbruotfcastsoft.com 
Hmai 1: in&@bftwla5t$oft com 
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Simply the best GUI Building/Event Managing libraries 
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Tools Plus 2.6 

Tools Plus gives you the routines you need to create 
a professional looking user interlace. 

Then we make it work. It's that simple. 




Language 
OC/C++ 
O Pascal 
® Both 


rq 

kUlIl JTJ 


^Ci>df Warrior t/C/C +4 PowerPC 

Symantec l/ Pascal b&thO 

* Over 170 high-pc rwer<fcl "set and fcigetf routines that automate and enhance: 
even! handling widows, the tool bar, ftqlljhg palettes, cursor, buttons, 

ptt lure bnuons, Mxotl burs, menus (pul I'down, hierarchical and pop-up), 
list boxes, fields, Edit menu, clipboard, Dynamic Alerts, and innre.. 

* Easy to learn and easy fci tree * fur novice, intermediate and 

* Substantial code reduction advanced programiners 

* I )r;irnatic code smiplifu/atiun * Runs fasif needs little metnorv ur disk space 

* Sign] f tea ntly less debugging * Safer I ban toolbox comings 

* System b arid 7 compatible * -No royalties 


14 

18 

24 

36 


M Saues Time 
SSaues Money 
M Easy to Use 
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Data 



The Script able Database Client 


DataScript is probably the quickest, 
easiest and most cost-effective way 

to make your integrated AppleScript 
solutions database aware - today. 


quickest. You can make new or existing scripted solutions database 
aware in a Hash. Ii takes just six lines of AppleScript to fetch data from 
an industry standard data!rase managemenl system such as Oracle, 
Sybase, DIS2 or Informix. We think you'll l>e pleased with it’s 
performance too it launches in an instant and is available accelerated 
for PowerPC. 

eas iest. I )si \ a Scrip! 1 s scri pt i ng vtxa I >u 1 a ryt >r t erm inc >1< )gy is ea sy u > 
learn, easy to use and easy lo remember. II you’ve done any Scripting 
Wore then you’ll lx* running with Data Script in no lime. If you’re new 
to AppleScript don't worry - “Inside DataScript ’ contains lots of easy to 
follow script snippets which you can reuse in your own solutions. 

cost-effective. Because DataScript is so easy to learn and easy 
to use you'll become productive very, very quickly. Once you’re ready 
to ship your finished database aware solution you'll find our licensing 
scherlies verv annulive. 


DataScript can be purchased from General Know ledge by phone* Telephone +14 1202 746 026 
fax or INTERNET using VISA/Mastercard or American Express. Fax +1 ] 1202 715 600 

DataScript is also available from the MacTec.h Mail Order Service INTERNET knowiedgable@appldink.ap.ple.com 























































PROGRAMMER'S 

CHALLENGE 


By Bob Boonstm, Westford, Massachusetts 



Sliding Tors 

You have all probably .seen small versions of the puzzle that is 
the basis for this month's Challenge: a i-hy-1 grid of interlocking 
tiles, with one empty trie among the 16 cells allowing the puzzle 
to Ixr scrambled by sliding adjacent cells into the empty location. 
This month the Challenge is to write code that will unscramble a 
larger version of the Sliding Tiles puzzle. 

The prototype for the axle you should write is; 


typrd o f ticiuHran /"IcpIMovcV (* MoveFroc J { 

F tailback pnxnlufe to move tikr al 7 
long t UeTaHoveRov, F thesecoordinates into the location 7 

long tileToMoveCoi F ofadjacentempty life 7 

); 

void S^IveTilest 

1 q n g * 111 es * F pal m cr to array of tiles where 7 

long nufiRowti* F rile(mw.col)bat 7 

long numCols, F "(tiles + itw'numGib + cot) 7 

H q v e F roc M i k e Mo ve F Callback pn xredure m move a tile 7 

); 


You will lx 1 given a pointer tiles into an array of tile 
values, the number of rows and columns in the puzzle 
(numRows and numCols, respectively), and the address of a 
callback procedure MakeMovc used to tell my test code about 
the moves you make to solve the puzzle. The tiles array 
will be initialized with the values 0. .numRows*nuraCols- i T 
in an order scrambled by the calling routine. The value 0 
represents the empty tile. 

Your axle should make a sequence of calls to MakeMovc 
and return when the puzzle is solved Each MakeMove call 
exchanges the empty tile with die indicated adjacent tile. The 
puzzle is solved when you have moved each tile into its 
proper location: moving the tile with value 1 into location 


tiles [i] (Le, row=i /mitnCols and col 1 *i%rmmCols). 

The callback routine will be something like the code 
provided below: 

Static long gNiim R oy s . gWm Cola; /'in ItlalIjttfd hy t tsi a ude 7 
s :ati< .emg gEmptyRow, gEmptyCol; F initialized by lest code 7 
static long *gTil«s: F initialized by test code 7 

#daf i ne T11 oVa 1 ue f r tips, row, call * (tiles+( row) * gMiuaColst (col)) 
tfdpf I m* Out Of Range (val« nun) l((val)<0) |j {(valj >-(mfnJ)) 

static Boolean MakeMove(long tiloToHoveRow.long tileToKoveCtil) 

I 

long diff; 

if (OutOfRange(-tileToMoveRov.gffunifhjys)) HHUtn false: 
if (OutQfRartgejr npTnMnvpCol, gNttmCols)) return false: 
if (tileToHoveRnw — gEraptyRow) ! 

diff - tilcToMoveCol gXmptyCol: 
t else if UileToMoveCol = gEmptyCol) I 
diff = tiieToMoveRow gEmptyRow; 
l else I 
return false; 

I 

if | (diff t= -i) ftk (diff !)) return false; 

Ti leValiietgTl 1 loo.gEmp Ly Row * gEmptyCol) * 

T11cValuetgTiles, tiieToMoveRow, tileToMoveCol); 
gEmpLykov = tileToMoyeRov; 
gEmptyCol = tileToMoveCol; 

Ti.eValue(gTiles.gEmptyRow,gEmptyCol) - 0 ; 


As an example, given the initial conditions: 

long tilesU - (1.4.0,3,5.21; 

SolveTiies(tiles,2.3,MakeMove); 


... you could generate the following moves: 

MakeMove(l,2); 

MakeMove{ 1 . 1 ): 

MakeMove(D«1); 

MakeMove( 0 . 0 ); 


Here's how it works: Radi month we present a new 
programming challenge. Finn, write some code dial solves the 
challenge Second, optimize you; tode (u lot). llien T submit your solution to 
MacTech magazine, We choose a winner based on axle correctness, speed, 
size, arid elegante tin dial order of importance) as well as the submission 
date, In die event of multiple a guilty desirable solutions, well choose one 
winner (with honorable mention, but no prize, given to the runner up) The 
prize for each month's best solution is a SI00 credit in the MacTech Mail 
Order Store and a limited-edition, "The Winner' MacTech Programmers 
Challenge" T-shirt (not available instore* anywhere). 

Unless stated otherwise in the problem statement, tiie Mowing rules apply 
All solutions must be in ANSI eumpuilrlt: C. Use only pure C axle Wei disqualify 
entries with any assembly In them (except for challenges specifically stating 
utltetwfee). You may rail any Macintosh Toolbox routine teg., it doesn't’nvmer if 
you use NewPir Instead of iruilloc). We test entries wkh compiler options set to 
disable FPtI use (for ftOxO axle) and to enable all available speed optimizations. 
The ormipikt To Iv used anti the target instruction set (680x0 or PowerPC) will lx j 


staled in U te pniblcm Limit your axle to 60 characters per line; 

tliis helps w ith e-mail gateways ami pge Lsyout, 

We publish the solution and winners for each month's Programmer's 
Challenge two months later All submissions must be received by the 10ih 
day of the month printed on the front cover of this issue. 

You can gel a head stain on the challenge by reading the online version. 
We post iL to the online services at the same nme that wo jxisr source code 
We make every efion to have it online no later than when the magazines are 
mailed, bui we re unable to guarantee that it will be online by any given date. 

Mark solutions "Attn; Programmer’s Challenge Solution’ and send it by 
e-mail ro one of the Programmer's Challenge addresses in the "How to 
Communicate With Us 1 ' section on page 2 of tins issue. Include die solution, 
ail related tiles, and your conuet info. 

MacTech Magazine reserves tlie riglit to publish any solution entirrtd in 
the Programmer's CliaUenge. Authors grant MatTeeh Magazine the extrusive 
right to puhlLsh entries without limtlaiion upon submission of each entTy. 
Authors retain copyrights ftx the code. 


THE RULES 
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Need to add plotting capabilities to your program? 

Save time and money with one of our three popular Supcrplot libraries 



Plotting/Graphics Libraries 

From $150 - $250 

498 E. Robin Road • Orem, UT 84057 


• Choose SuperPlot, SuperPlot+, or SuperPlotPRO 

• PowerMac version available 

■ Works with Fortran, C or Pascal 

• Data analysis 

• Batch processing 

• 19 plot types 

• Windows 95/NT version available for 2D and 3D 

• New - Works with Code Warrior! 

For free demo and info contact SuperSoft 

Voice (801) 225-4356 • Fax (801) 226-6276 



http://www.SuperSoft.com 


... to transform the puzzle like this: 

14 0 —> 14 3 => 14 2 => 10 2 —> 0 12 

3 3 2 35 0 3 0 5 3 4 5 3 45 

It turns out that half of the* possible permutations of the 
values 0, .numRuws*numCols■ 1 are “illegal" in ihm ihey 
cannot he reached from ihe “solved" suite. The calling routine 
will provide a legal starting state - you don't have to worry 
alv)ui the puzzle being unsolvable, 

Ihe number of moves you make to solve ihe puzzle is not 
an explicit criterion in determining the winner, but the winner 
will lx* determined by total execution time, including the time 
used by the callback routine, as we did in the Master 
Mind Reader challenge a few months back. Note that you are 
not permitted to optimize the callback routine - its purpose is 
to provide a fixed time penalty for each move your solution 
routine makes. 

This will lx* a native PowerPC Challenge, scored using the 
Symantec 8,0.3 compiler. Good luck. Email me with any 
questions, or - beuer yet join the Programmer’s Challenge 
Mailing List... 

Mailing List Reminder 

Many Challenge readers have already joined the Programmer’s 
Challenge Mailing List announced last month, The list is being 
used to distribute the latest Challenge, provide answers to 
questions about Ihe current Challenge, and discuss suggestions 
for future Challenges, The Challenge problem is posted to the 
list sometime between the 20th and the 25th of the month. 

To subscribe to the list, send a message to 


autcxshare@macTech.cojn with the SUBJECT line **sub challenge 
YourNamc", substituting your real name for You rN a me. To 
unsubscribe from the list, send a message to 
autashare@maaech.mm with the SI rBJECT tine Tmsuh challenge". 

Two Months Ago Winner 

Congratulations to Eric Lengyel (Blacksburg, VA) for submitting 
the fastest entry to the Enc iosingBounds Challenge. The 
problem was to find die smallest rectangle enclosing all of the 
non-white pixels in a PixMap, Eight of the 13 entries submitted 
worked correctly, but Eric’s solution was significantly faster 
than the others. This is Eric's second victory in three months, 
following his first-place finish in the September Reversible 
Scrambling Algorithm Challenge. 

The winning solution uses a clever technique to minimize 
the number of comparisons required to find the enclosing 
rectangle. Rather than test each pixel to determine if it is non- 
white, Eric logically ORs the values for all pixels in a row (for 
the indexed color cases), taking advantage of the fact that 
white is always represented by a zero value. A single 
comparison then determines whether that row contains only 
white pixels. Working separately from the top and Ixitfom of 
the selection rectangle identifies the top and bottom rows of 
the enclosing rectangle. A similar technique applied to columns 
finds the left and right boundaries of the rectangle. Eor the 
direct (32-biO color case, the approach is similar, except that 
pixel values in a row or column are logically ANDed, taking 
advantage of the fact that white is represented by the value 
OxOOFFFFFF. 

Here are the times and code sizes for each of the correct 
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hen it crimes in text editing have you 
ver Etojved for a little divine inter¬ 
vention? Well if it hasn't arrived yet 
you,should he considering PAK1K 

Whether you're developing tlie next “killer" inter¬ 
net application, building a custom publishing tool or 
adding advanced word processing Id your CAD pro¬ 
gram, you can't ignore the quality of your text editor. 

With PAiGli you can create die most sopltis 
licaled text features in tlie business. Including: 

• Stylized Itat 

• Ifext Wrapping 

• Embedded Objects 

• Shapes & Containers 

• Virtual Memory 

• Style Sheet Support 

• Multi-lingual Capable 

• Portable C Code 

• Royalty Free 

I’AIGE is written in portable C and uses no global 
variables. Machine specific code is minimized to 


ensure a consistent API 
for all platforms— 
simplifying multi- 
platfomi development 
This strategy allows 



you to move your 
application to oilier 
J platforms while main¬ 
taining data and application compatibility. 

To simplify tlie integration of PAIGE into Windows 
(16-bit, 32-bit, '95 or NT) applications, our library 
ships as DLL's and can be usd as a custom control. 
Combined with tlie message based demo source code 


and simple introduction guide, PAIGE gets programmers 
up and running quickly. 

So why should you buy PAIGE? TIME. Programmer: 
can't afford to reinvent the wheel when implementing 
advanced text features within their applications. 

Join the hundreds of major software publishers 
using PAIGE as their total text solution. For a complete 
technical and pricing summary, or to request our prod¬ 
uct demo, contact the DSI sales department today at 

80(1-327-6703 or .160-973-91 S3 


DataPak Software Inc. 

9317 XE Hwy 99. *G • Vancouver, WA 98665-8900 
Bus: (360) 573-9133 • fax: (360) 573-9269 

Internet: 76424.3027@compusene.com 
www.tdeport.com/-datapak/datapak.html 
AppleLink: D0142 • AOL: DATAPAK 1 
• CS: 76424,3027 


“Say, nice job brother John. Now could you make it a three column 
format with digital memos embedded in the text stream?” 


entries. Numbers in parentheses after a person’s name indicate 
that person's cumulative point total for all previous Cliallcnges, 
not including this one. 


Name 

time 

time 

time 

test 

code 

data 


1-hit 

8-bit 

32-bit 

time 

size 

size 

Erie Lengyel (20) 

13 

66 

272 

340 

1608 

320 

Ernst Mimter (100) 

22 

96 

326 

427 

2980 

32 

Miguel Cruz Picao 

34 

110 

476 

593 

3328 

44 

John Sweeney 

75 

145 

502 

659 

4416 

624 

Bill Karsh (78) 

54 

135 

517 

662 

1600 

8 

Tom Saxton 

146 

170 

560 

758 

1044 

132 

Chris Rudolph 

514 

289 

973 

1354 

1420 

8 

Pi 

6197 

4672 

5384 

1118! 

656 

24 


Compiler (version) 

time 

1-hit 

time 

f^hit 

time 

32-bit 

MrC / MPW (1.0© 

10 

52 

183 

Metrowerks C (1.3-2) 

13 

66 

272 

Symantec (8.03) 

17 

75 

292 


An investigation of the generated code provides some 
insight into these numbers. Code Warrior generates the 
following code for one of the inner loops in the winning 
solution: 

for Ci - 0 ; i < muriftolrtterdH: 1 ++) 

00000064: 7D274B78 ®r r7*r9 

00000068: 38AGQ0QD li rS,0 

0000006C: 48000014 b *+20 : $00000080 

t 


Tlie times listed above were all achieved using the 
Metrowerks Code Warrior 7 compiler Running the winning 
entry with code generated by the Symantec and MrC compilers 
(with all speed optimizations enabled in each case) gave some 
interesting results, with the MrC code executing in 2/3 to 3/4 of 
the time required by the others: 


accumulator I* 
k += 4: 

i 

‘(long *) k; 

00000070: 80070000 

Ivz 

rO * 0 (r 7 ) 

00000074: 38A5Q001 

addi 

r5* r5 * j 

00000078: 70610373 

or 

r3,r3*r0 

GO0OOO7C: 38F.70004 

add! 


00000080: 70052000 

cnipv 

r5,r4 

00000084: 41KOFFEC 

bit 

*’20 : 


$00000070 
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The #1 debugging and development environment for AppleScript ! 



• Real step-by-step debugging 

• Variable watcher & 
expression evaluator: set 
variables, in context, during 
debugging! 

• Enhanced trace log 

• FaceSpan' M link 


* Vocabulary access in a 
mouseclick 

* Power-assisted statement 
construction 

* Multifunction find & replace 

* Automatic navigation to 
subroutines 

* Background processing 


_ 

X 

% 


p 

2i 

II 

i 
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f you're an AppleScript novice, Scripter will take you by the 
hand and show you the correct syntax for your statements. 
If you know what you're doing, Scripter will help you do it 
faster than any other editor. Scripter lets you debug properly: 
truly line-by-line, so you catch the offending code in the act. 
And only in Scripter can you then fix the problem, and 
continue debugging — right from where you left off. !n fact, 
Scripter has so many exclusive features, we can't list them all 
here. So get a copy today, and start scripting with power! 

"Overall value ♦♦♦♦♦ 

Scripter 1.0 is fop AppleScript editor and debugger... 
If you expect to do anything more than idle fiddling 
with AppleScript you need Scripter." —MacWeek, 6/12/95 


ORDERS 

ONLY 


+1 2022989595 mainevent@his.com AppleLink: MAIN.EVENT 


By comparison, MrC generates the following longer, hut 
faster code; 

for (1=0; £ C mmWholeWords; i++J 


OOFS 

006C 

48000018 

b 

$+0x0018 : 

0x00000004 

OOKC 

00 JQ 

X 4RB00020 

blr 



□ 100 

00/4 

31290001 

addle 

r9,r9,l 


0104 

00/8 

/D4A3814 

addc 

r 10 * r 1D ♦ r 7 


0108 

Q07C 

X 7CO93000 

totpw 

r9,r6 


010C 

0080 

X 4O80FFFQ 

bge 

$-0x0010 ; 

0x00000070 

0110 

0084 

X 40990028 

ble 

cr6, $+0x002B : 

(JxGOOOOOAC 

0114 

ooas 

X 7D0903A6 

mtctr 

r8 ; 

CTR = 9 

ona 

ODBC 

X 2CO8O0OJ 

cmpwi 

r8,1 


one 

0090 

X 4181000C 

bfit 

$ 10x000C ; 

Ox0000009C 

0120 

0094 

X 38600001 

li 

r3J 


0124 

0098 

X 7C6903A6 

mtctr 

r3 ; 

CTR = 9 

ona 

CG9C 

i 

X 318AFFFC 

subic 

rli,rl0,4 



1 

ac^umiilarar 

[= ’(long 

*) k; 



i 

k 4— 4: 




0I2C 

i 

00 AO 

846C0004 

Iwxti 

r3.0x0004(ri2) 


0130 

G0A4 

7C6B5378 

or 

rl1♦r3,r 1 1 


0134 

OOA8 

X 4200FFFS 

bdnz: 

$ 0x0008 ; 

OxOOOOOOAO 


Notice that the inner loop is 6 instructions In the 
Code Warrior version but only 3 instructions in the MrC code. 
The key to the difference is the use of die mtctr, lwzu, and 


bdnz instructions. The mtctr instruction loads rhe special 
purpose CTR register, which the bdn* Instruction decrements 
and tests, branching when CTR is nonzero (similar to what the 
DBRA instruction does on 68K machines). The bdnz 
instruction replaces 3 instructions generated by CodeWarrion 
The Ivzu instruction loads a value from memory, but also 
stores the effective address back into the register used for the 
indirect memory access, replacing 2 Code Warrior instructions. 
Reading disassembled compiler-optimized PowerPC code takes 
a little practice, bur it can provide some insight into what the 
compiler is doing to you (or tor you). Those interested in 
learning more are referred to the many PowerPC articles in past 
issues of MacTech, including a two part series by Bill Karsh in 
August and Sepiemt>er of 199^- 

Top Contestants or All Time 

Here are the Top Contestants for the Programmer's Challenges 
to date, including everyone who has accumulated more than 20 
points. The numbers Mow include points awarded for this 
month's entrants. 
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Get Your Name “In Lights” 


n ere at MacTecb Magazine, we rely heavily on outside writers 
for most of the material that appears in our pages. If readers did 
not participate in the magazine, sending us their ideas anti taking 
die dine to write articles, there would lie no Mac Tech We like to 
think of MatTttch as an ongoing dialogue amongst mem liens of the 
Mat programming world: we facilitate the discussion, hut it's the 
readers who carry it on, hy responding to what they read and to 
their own programming experiences and interests, in writing. 
Sometimes we know that we need something specific covered, 
and we approach someone to write an article on dial subject; and 
we do write a lew columns in-house each month, [hit il is reader 
contributions, in the form of letters, rips, and especially articles, 
that give the magazine its relevance, its character, and its appeal 

No MucTecb Magazine ts nor a staff of writers sending a 
const ant stream of one-way messages outwards, it’s a living, 
evolving network of readers conversing with one another, 
educating one another, sharing their know ledge, their experience, 
their interest, their trials and tribulations and joys and successes in 
the constantly unfolding story of programming the Macintosh. 
MacTedt Magazine doesn'i just liappen: it’s what the community 
makes it. If we carry reports of future trends and Ledinolpgies, if 
we teach useful mcthtxls, if we review new I Kinks anil tools, if we 
provoke thought, provide help, ride the wave of current interests 
and concerns, it Is only because we reflect the thoughts of our 
readers, who speak through our pages. 

You arc invited to involve yourself in this exciting convensation 
amongst readers. You may be working at the cutting edge of 
pmgra m m i ng tedilk>krgy, as pa 11 i >f a hca vily fu nded prolcssk ma t 


Don't 

Take 

It's a 


developer effort; you may Ik- a lone hobbyist w restling to create 
si ta new am for the sheer love of it. You may liave been programming 
the Mac since its inception; you may have just switched over from 
Windows or Unix. You may work in C or C++ or Pascal or 
AppleScript, from scratch or in a framework. You may write big 
apps, small apps, custom solutions, extensions, code segments, for 
profit, for fun. for education, to solve one problem once No matter 
who you are, no matter what your credentials may tv, if you have a 
tale to tell, a trick to share, a technique to leach, we want you to 
consider joining the family of those who write for M/uthh. 

Don't just wait for a topic to fv covered in MacTech? 
just wish some technique would be explained better! 
rcsponsJMtiy! Write us an article yourself! 

To write for MacTecb, just send for our Writer's Kit. 
Microsoft Word file containing the Styles you need to use, and 
giving tors or lidpful advice and information, including all the legal 
stuff. You can let us know what you're writing about, if you want 
suggestions or feedback; this Is hclplul to us, because it lets us 
plan for the future. Or if you want to, you can just write the article 
and spring ii on us when it's clone. If we publish your article, 
you'll be paid for ill 

Write to me, Man Neubuig, at munaging_ed®mnett‘ch.com (or 
one of the other editorial addresses listed on page 2 of the 
magazineJ. Ask me for a Writers Kit! Send me an article! Get 
published! Make money 1 Nee your name in print up there 
alongside the famous denizens of MaeTech! ,».*«**,* 

And, most important* take the future of * _ |L 

MacTqch Magazine into your ow 11 1 la mis! fV/clC "■ f® 00 


Rank 

Name Points 

Rank 

Name Points 

1. 

[Name ddcicdl 

176 

11 

Mallett, Jeff 

44 

2. 

Munter, Ernst 

110 

! -1. 

Kasparian* Raffi 

42 

3. 

in 

81 

13. 

Vineyard, Jeremy 

12 

i 

Kamhj Bill 

80 

14. 

Lengyel. Eric 

40 

5, 

Larsson, Gustav 

67 

11 

Darrah, Dave 

31 

6. 

Stenger, Allen 

65 

16. 

Landry, Larry 

29 

7. 

Rilia, Stepan 

51 

17. 

Elwatowsk i, Tom 

24 

8. 

Goebel, James 

49 

18. 

Lee, Johnny 

22 

9. 

Nepsimd, Ronald 

47 

19. 

Noll, Robert 

22 

10. 

Cults* Kevin 

46 





There are three ways to earn points: (1) scoring in the top 
5 of any Challenge, (2) 1 King the first person to find a bug in a 
published winning solution or, (3) being the first person to 
suggest a Challenge that l use. The points you can win are: 

1st place....20 points 5th place... 2 points 

2nd place,.,,..,.10 fxrinis finding bug...2 points 

3rd place..7 points suggesting Challenge. ..2 points 

4th place..4 points 

Mere is Eric's winning solution: 


EnclqsingBounds 

Copyright ® 1995 Eric lengyel 

r 

This algorithm is based on ihr following kka. Assuming ih.it wc are gt>ing to have to 
cha k many rows or columns which don’t contain any non-wliitc jnxcb, it is faster to 
combine all of the pixels in 3 raw or column and took at die end result than it b m 
check each pixel individually Tilts is done fay ORin^ entire rows or columns 
together for 1 fail and 8-bii deep pixel maps ami ANDinj; entire rows or columns 
together for 52-bit deep pixel maps. Ilie two liiltcruTU methods are necessary 
because for t bit and 8-bit pixel maps, white is represented hy zeros and for 32 bit 
pixel maps, while is represented by ones 

The mask tables below are used with I bit and 8-hit deep pixel maps. They are 
needed when tlie left or right side of the selection rectangle is not word aligned. 

7 


long LeftMa.sk![321 = 

(OxFFFFFFFF, 0x7FFFfFFF, OxTFFFFFFF, 
OxOFFFFFFF. 0x07FFFFFF, OxOlFFFFFK. 
OxOOFFFFFF, OxOO/FFFFF, 0x003FFFFf. 
OxOOOFFFFP* 0x000/FFKF* 0x0003FFFF, 
OxOOOOFFFF. 0x00007FFF, Gx00003FFF, 
0x0000OFFF. Qx000007FF. 0x000003FF. 
OxOOOOOOFF. 0x0000007F, QxG000Q03F* 
0x000000OF. 0x00000007, 0x00005001, 


Ox IFFFFFFFh 
0x01FFFFFF* 
0x001FFFFF, 
0x0001FFFF* 
0x00001FFF T 
OxOOOOOlFF, 
0x0DO000 IF* 
OxOnOGOOOI 3 I 


long RighrMaski[ 32 ] - 

fOxBOOOOQOO* OxCOOOOOOO, 
GxFBOOOQGO. OxFCOOOOOO. 
OxFFBOOOOO. OxFI-mOOOO* 
OxFFFBOOOO* OxFFFCOOQO. 
OxFFFFBOOO * OxFFFFCOOO, 
OxFFFFFSOG. OxFFFFFCQO* 
QxFFFFFFBO. OxFFFFFFCO, 


OxiiOOOOOOO. 
OxFEOOOOOO, 
OxFFEOOOOO. 
OxFFFEOOOO. 
OxFFFFEOOO, 
OxFFFFFFOO, 
OxFFFFFFEO, 


OxFOOOOOOO* 
OxFFOOOOOO* 
OxFFFOOOOO, 
OxFFFFODOO * 
OxFFFFFOOO, 
OxFFFFFFOO* 
OxFFFfFFF0 T 
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Guide Composer 

Previewed at WWDC ‘95 

Develop Apple Guide files for any 
new or existing application 

Available fiw: the M acTcc h Mail Order Store 

Demo Available: ■/* 

AppleLink, AOU CIS, 
eWorld. lnLertiet:lnfo-Mac M 3 C OS 

Kindr l iv > tmfcnwli •TSWfU* SfUftnc MaL* « i V-Jemui irf Apr* l 


• No Programming 

• WYSIWYG Content Entry 

• Coach Marks 

• Index Terms 

• PICTs 

• Sounds 

• Integrated with Guide Maker Lite 
(included) For Easy Compiles 

• Optional Source Code Output 

• Change back from your $100 


nilP 7110Glendora Avenue 

5 > I t H Dallas. Texas 75230 

CnCTUUARC 214 - 360 9301 

bUrlWAnt 214-360-0127 fax 


$99 


UxFKFFFFFa* OxFFTFFPfC, OxFFFFFFFE. OxFFFFFFFF\; 
long UftttaskSUl - 

IOxFFFFFFFF, UxOOFKFFKF- OxOOOOFFFF. OxOOOOGOFFh 
long RightKtsk8{4| - 

nxFFOnOOOO* OxFFFFOOOO. OxFFFFFFOO. OxFFFFFFFFI: 

long iliM-rrtfh If _ OxGOFFFFFF; // Value of while pixel 

// in 32-foit 


void EnclosingBaundslPixRapHandltf pm. 

Rpct fiolfiction, lect *eneiosingRect) 

I 

PixHflpPl r map; 

long pixel Size, rowBytes, accumulator, 

leftHask. rlghrHaisk. baseAddr* 
leftSide* righlSide, fopSide* bnrttmSide. 
mjalfholeWords. needLeflMask. needftightHask* 
i, j, k. 1. 

map * *pm; 

r Ci impi lit- position of selection rtvtangk relative to upprr lcft cormr of ptxd map 7 

leftside “ selection*left map >boitmin. left; 
rightSidfi - selection, right map Hounds, left \ 
topside - selection.top - nap-Hounds.tup; 
horromSide - selection,bottom map Hounds, Lop; 

t Llicek validity of flection rectangle. 7 

if UrightSide <“ IcftSidc) |[ (borronSide <-* topSideJ) 
t 

enclosingRectOlett s endosingRcct >rlght “ 

enclosingRect->top - encioslugttect >bolto» " 0; 

returni 

I 

r IXlCTTumc cturxicrislics of pixel map. 7 

rowBytes - map*>rowBytes: 
if frovBytes r 0) pixeiSIze = 1; //BitMap 

elne pixelSize - map*>pixelSize: //PixctMap 

rowBytes k* Ox'lFFF: //Strip flafes 

baauAddt " (long) map * HaseAddr; 


p \landIc I-hit and fWrit deep pixel maps with name chunk 
of code. 32-bit deep pixel map handled separately. 7 

if (pixelSize != 32) 

I 

/' Move baseAddr over to the first column of I In selection nviiflglc, still keeping it 
wort! aligned. Then determine whal masks arc needed for leftmost and rightmost 
words in rhe selection and how many whole words then: an* in between. 7 

if (pixelSize = 1) 

t 

baseAddr (leftBide » V) « 2i 

leftHask - LeftHasklUeftSldc & 0x1 Kjs 
rightMask - RightHaskI [ (rightSide 1) h Oxlf]- 
mimWhGletfords = (rightSide » 5) * 

((leftside + 11) » S)| 

I 

else 

I 

baseAddr +- leftside k tJxFFKCi 
leftMask - LeftMaskB|IeftSide & 3): 
rightMask “ RightMaskSLCtightSlde t) h 3]! 
mimWholetfordu ■ (rightSide >> Z) 

((leftside f >> 2): 

I 

/* Set flap indicating what masks art' in use If the* left and right Ixmndaries of the 
selection fall within the stifle word, then lake the intersection of the left and right 
masks and only consider otic cokmm of words 7 

needl-cf t Mask = (leftMask + I !- 0): 
nuedRlgbtHusIt “ frlghtKafik * l !* 0); 
if EnumWholeWords < 0) 

t 

leftMask ^ rightWaek: 
needRightMask = 0: 

J 

r I md first row wtttl a non-while pixel hs ORmg tile 
w hole row together and checking for a norwrro result 7 

j - topSide; 
accumulator - 0: 

m " baseAddr + j * rowBytes: // Top-left comer 
do 
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StoneTable Break on through the limitations of the List Manager 


StoneTable 






Name 





Home 

Address 




Father 


John Smith 


_ 


_ 


2138 NE Halsey 
Apt 3 

Portland, OR 97232 


Think C, CodeWarrior C, CodeWarrior Pascal, MPW C (68K or PPG) 
Think Pascal, MPW Pascal, Prograph CPX (68K only) 

88 K StoneTable $150 StoneTableExtra $50 {per compiler) 

PPG StoneTable $100 StoneTableExtra $25 (requires 68K) 
International shipping (US Airmail) $10 
No royalty fees for applications 


Row and column titles 
variable size row and columns 
move, copy, sort, hide, resize rows and columns 

edit cells in place 
validate data entry through callbacks 
set font, size, tore/back color, face, alignment per cell 
cell margins, top/bottom & left/right 
68K support for both A4 and AS worlds 
TDEF-like" custom drawing function 
greater than 32K data per table 
plus all List Manager functions and more 

StoneTableExtra 


CodeWarrior C package includes PowerPlant Class 


StoneTablet Publishing 
P.a Box 12665 
Portland, OR 97212 
voice/fax (503) 287-3424 
s tack @ te I epo it com 


Demo - ftp://ftp.teleport I com/pub/vendors/stack/StoneTableDemo T hqx 


drag cells in and between tables 
PICT support 
popup menus & check boxes 
draw boxes around multiple cells 
variable size grid lines 
controls in cells 


k “ it; 

If (needLeftMaak) 

I 

accumulator |- CMlang *) k) & leftMask; 
k +~ 4i 
I 

for (1 ”0; 1 < numtfholeWords: *++} 

I 

ocrumnlalut |- Mlorig *) k; 

k +~ 4; 

I 

if (needRightMask) 

I 

accumulator 1“ ('Hong k) k n'ghrHask; 

) 

if (accuiulator !* 0) break; 
n 4* rowBytes; 

\ while (++j < bettomSide) : 

if (j “ bottomSide) // Wfook selection is while 

f 

enclosingReet->le£t enciosingRerT^righr = 

enclesingRect - >top ” ehrlmrinBRert >bottom ~ 0; 
return* 
i 

LopSidt = j: 

t Find hst row with a non-white pixel 7 

j - bottomSide ■ 1; 
accumulator = 0; 

m “ baseAddf * J * rovRyt on; // Bottom-left comer 

do 

I 

k = in: 

if (iieedteitMask) 

I 

accumulator (■* (*(long *) k) 4 IpftHa&k; 
k +- 4: 

I 

for (i * 0; i < numWholeWotds; i++) 

t 

accumulator | = ‘(long *) k: 
k += 4; 

1 

if (need Right (task) 


accumulator |- (‘(long *) k) & rightMask; 

1 

if (accumulator l~ 0) breaki 
ra rowByts*: 

I while ( j lopSideJ; 
boLLomSide = j + 1; 

f Find leftmost column containing a wm-while pixel. 7 

accumulator = €; 

n = baneAddr t topside * rowBytoo: 

1 - 0; 

if (neeilLefLMaak) 

{ 

k = m: 

j = topSide; 
do 

t 

accumulator j- (*{1ong *) k) & lcflMuuk; 
k rovBytes; 

I while (++j < bottomSidu}: 

II (accumulator !” 0} goto Aeftfaund; 

1+^4: 

1 

for (i ^ 0; i < numVholeVotda; lit) 

f 

k = m + 1; 

J *■ topside: 
do 

t 

accumulator |- *(long *) k; 
k rowBytes: 
i while f-H-.f < bottomSIde); 
if [accumulator 0) goto leftFound; 

1 +- 4; 

} 

if (needRigbtKask) 

( 

k = us + l; 

j - topside: 

do 

I 

accumulator |= (' (long ■) k) k righiHa^k; 
k +“ rowRyLet:; 

J while (++j < bottomSide): 
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It’s Macintosh Accounting At Its Best 




E X 1 B L E 


Rex Ware is designed 
to give you a]most 
unlimited possibilities 
as your company 
grows. 


p 

O W E R F U l|{ V 


f 

Flex Ware’s accounting 


/ l 

features and reporting 

mr ^( 

( ^***1 

capabilities give you 



information you’ll 



rely on daily U> make 



smart decisions. 




Large businesses consis¬ 
tently choose FlexWare 
because of i ts exceptional 
speed on network and 
client/server systems. 


Meet your clients’ needs with the FlexWare Development 
System. FlcxWare is an integrated, modular ,MacUser Recommends 
award-winning accounting program that you can modify and 
customize to suit each of your clients' requirements. Take advan¬ 
tage of FlexWare’s lop performance and adaptability. It’s flexible. 
It’s powerful. It's fast. Call the FlexWare Sales Department at 
800-447-57(X) for information on the FlcxWare Development System. 


FlexWare 


ACCOUNTING 


SMTEOFTHEART 

ACCOUNTING SOFTWARE 


8211 Sierra Cpllcge Blwl. t Suite 440, Roseville, CA 95G61-9406 - ft 916-791-7730 * FAX 916-791-552$ ■ 1-860-447 5700 


r Wllcll wc get to here, wr have narrowed down the left-most nomwhilc to the 
word The value in the accumulator will tdl us rht- rxaci column of the pixel. We 
then move haseAddr over Lo the LsE column of the selection rectangle (word 
aligned). 7 

leftFound: 

if (plxelSize *» l) 

l 

leflSide - (IcFtSidc h QxFFFFFFEO) » (1 « 3); 
while (accumulator 0) 

I 

ieftSide-H-: 
accumulator «« 1: 

j 

banoAdrir 11 [long,) map >baseAddr + 

(([>IgbtSIdfi l) » 5) « 2); 

else 

( 

leftside - (leftside & OxFFFFFFFC) + 1; 
while ((accumulator & OxFFOGGGGO) “ 0) 

I 

loftSide+4; 
accumulator «" 8; 
l 

baseAddr = [long] map >bHSeAddr + 

({rightSide - 1) h DxFPFC); 


r find rightmost column containing ;i non-white pixd. 7 

accumulator * 0* 

m « baseAddc + tupSidc * towBytes; 

1 * Oi 

if (needMghtMask) 


l 

k “ m: 

j = topside: 
do 

I 

accumulator |= (Mlong *) k) £ rightMask: 
k +“ rowBytos: 

\ while (++j < hot totnSIde): 
ii [accumulator l 1=7 0) goto right Found: 

1 4: 

l 

for (i = 0: i < numWholeWords: i++j 

I 

k ” m ■ 1; 
j = Lopsido: 
do 
( 

accumulator |« *[long *) k: 
k +- rowBytes; 

) while (+*i < bottomSide): 
if (accumulator 1“ 0) goto rightFound: 

1 ^ 4: 

1 

if (needLeftKask) 

( 

k - m - i: 
j = topSide: 
do 
t 

accumulator |~ (•(long *) kj & leftMask; 
k rowBytes: 

} while (++j < battymSide): 

\ 

rightFound: 

If (pixelSize “ 1) 
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◄ ◄ ◄ ◄ ◄ 


Draglnstall 2.0 

Here’s proof 

that the more things change 

New “Quick Build" option lets you build a complete installer in one easy step. 
New features such as locating files and folders, applying patches, and 
replacing outdated files allow you to build more intelligent installers. 

Improved support for installing non-archived files simplifies the creation of 
CD-ROM and network installers. 

PowerPC-native compression and decompression cuts installation time in half. 
AppleEvent and scripting support allows installations to be automated. 

the more they stay the same 

▼ Same price — $300 lets you distribute an unlimited number of installers for 
all of your products. No yearly fee, no royalties, no hidden costs, 

▼ Same drag-and-drop interface familiar to all Macintosh users. 

▼ Same reliability and robustness that developers have relied on since 1991. 

▼ Same support policy — free technical support and low (or no) cost upgrades. 


For more information or a free demo call 1*800-890-9880 
or visit our Web site at http://www.sauers.com/draginstall 


Ray Sauers Associates * 1187 Main Avenue, Suite IB * Clifton, NJ 07011 USA * voice: 201478 1970 • fax: 201478-1513 ■ email: info@sauersxom 




t 


You’ve spent 

enough 

time in 
development. 

Don’t let your 
installer keep 
you from going 

golden. 


Oeitinatton 


|iKer ^|jh( tilt'd (older 
Ai Uecr ^pacified Disk 
,Q Marlup disk 
0 Oesklnp 

L»j Hi lino Bpplc Menu Items | 
Ri line Control Panels 
[01 Mi.lion EtilensiDns 
Gil RLtiMB Fonts 
0J Hr hop Preferences 
ReHufl liarti»|i Items 
[fij Pi tine System Folder 



Processor 
Hoy 600x0 
Rrty PowerPC 
&B000 

or mgner ebohd 



Just because your 
software is done doesn't 
mean your work is. You 
still have to write mi 
installer. And that can 
add precious days or 
even weeks. 

With Aladdin 
Systems' proven 
installation standard, 
Stuftlt InstallerMaker,'' 
you can have your 
PowerMac or 680x0 
product ready lo ship 
literally within minutes, 
and save money to boot. 

Stufflt InstallerMaker 
uses our advanced 
compression technology 
to reduce the number 
of disks needed to ship, 
which saves you money 
on every unit. Its menu 
driven interface is so 
easy-to-use t hat even 
your VP of Sales could 
prepare your installer. 

New version 2.0.2 
adds full PowerMac 
support, improved 

adaptability, 
and 

expanded 
localization, 
including German, 
French, and Japanese. 

To receive a free, 
tolly-working copy of 
StufTIt. InstallerMaker, 
call our licensing 
department today at 
(408) 761-6200. ’ 



G l<m Qrm 

VtdKtttfne. t A KD7G Wm. 1«M) TCI ,Wi - a 
IhiW JM JUHIIN 1 m*m* 


Usditm Syttriru. |m Ml i4krf pmluris mv 
tmli (j| Ihnr nwpccWw" hnWii*. 


rightSlde - UrightSido + 31) h OxFFFFFFEO) (1 « 33; 
while ((accumulator b l) “ U) 
l 

rightSide■ ; 
accunulator »* l; 

\ 

l 

else 

I 

rightSidc " ((rightSide + 3) b OxFFFFFFFC) I: 
while ((accumulator b UxOUOUUOFF) = 0) 

f 

rightSide■■; 
accumulator »* S; 


I 

J 

I* Now for ihr code which handles 32-bit deep pixel maps For direct pixels white b 
ui>e?i h unlike indexed pixels where white is zero* Wc will use the same technique, 
but wc will have to AND the rows and Columns together Wc dun'l have to worn- 
about left anil right ttusks - in 32*bit deep pixel maps even' pixel b word aligned 7 

else 

I 

bnseAddr += leftside C< 2: 

numWhnlcWords - rightSide leftside; 

t Find first row *f 

j ~ topSide; 

accumulator ■* Di recrWh j re; 
m = baseAddr + j * rowEytflsj 
do 

l 

k - m; 
i “ 0; 
do 

i 

accumulator ’(long *3 k: 
k += 4; 

I while (++i < tiumWholeWocds); 
if (accumulator I” DirectWhite) break; 
rc += rowBytes; 

I while C++! < bottonSide); 

if (j “ bottomSlde} // Alt while pixels 

I 

enclosinglect >left - cmclosingftoet >righl ^ 

oncl oslngRet t Hop ” uacloftlngKect >botloai - 0; 
re t urn; 

I 

topSide = j: 

r Find last mw. 7 

j = bottonRlde - I; 
accumulator ~ EH reelWhile; 
m ” baseAddc + j * rowBytes; 
do 
I 

k “ in: 
i » 0; 
do 

I 

accunolatur b~ '(laha *) k; 
k. t A f 

I while (++i < miaWholetforda); 
if (accumulator !“ DirectWhite) break: 
m ™ rowBytes: 
l while (“j >= topSide); 
bottomSide ■ j + I; 

r Find leftmost column. 7 

accumulator - UirectWhite; 
m - baseAddr + topside * rowBytes; 

1 - 0 ; 
i - 0; 
do 
l 
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k ~ tn + l: 
j = topside: 
do 


aecumulatcrr '{tong *) k; 
k += rowByieti: 

] while (4+j < bot uimSido); 
it (accumulator 1 = DirectVhite) break; 
1 +*■ 4: 

I while (++i < numWh ole Words): 
le.ftSide 1=1 >> 2: 

P Find rightmost column, V 

base Add r = (long) map >bascAdclr + 
(rightSide << 2 ) 4: 

accumulator - DirectWhite: 
ra = baseAddr I topside * rowBytes: 

1 = 0; 
t - 0; 
do 
( 

k = m - 1; 
j = topside: 
do 
I 

accumulator &= '{long *} k; 
k 1= rowBytes; 

I while (++j < bnttomSide); 
if (ftccLitmilalor l- Dt rect.Whi te) break; 

1 += 4: 

\ while f+4i < numWhoieWords); 
rightSide -- 1 » 2: 


r Return enclosing rectangle in the pixel map s load coordinates, 7 

encloaingRect >1cTt “ leftside 4 map->bounds.left: 
enciosingRect >rigbL = righLSide 4 map- >boundn, 1 eft: 
enclosingRect->top = topSide 4 map Hounds,Lop; 
enclosingRect->botioEi « bottomSide 4 map- Hounds, top: 



Visit MacTech Magazine’s Web site! 

http://www.mactech.com 



DON’T FORGET! 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

productinfo@xplain.com 


ALL BUSS ARE STUPID. 

But spending tedious hours trying to track them down is dumber still. 
Why not let a tool do the work? QC can find many of those mistakes 
automatically. Ever write data beyond the end of a memory block? 
Ever rely on a handle that was purged? Ever call DispOseHandle on a 
resource or ReleaseResource on a handle? Sure you have! Maybe you 
just haven't found out about it yet... QC finds these errors and more. 


YOU HEED: 



BECAUSE: 

Every programmer makes mistakes. 
All programs ship with bugs. 
Marketing just cut the beta. 

You could use some sleep. 


QC is cool and, unlike other development tools, QC is easy. Try it FREE: 

1. Connect to our web site 
1 Download QC (less than 20GK) 

3. Send us email to get a serial # 

4. Run the installer 

5, Run your program 

6, Press shift-option-q 


"I only hove 6 non-Apple Contra/ Panels an 
my development machine. QC is one of 
them. 'Muff said" 

-Bill Goodman. Compact Pro author 


"We wouldn't ship a product 
without QCs approval,” 
-Mote Gross, Claris Corporation 


HOW POWERPC NATIVE ! EXISTING USERS UPGRADE FREE! 


w 


Ony* Technology 7BI I 27ih Ave Bradenton, FL 3420? 

Tel: 941.795.7801 Fay 941.795.5901 
Web: h ttpzff www, i Ed .Mm/onyxCedi/ 
AOL: OnyxTech AppleLink: D2238 CIS: 70550.1377 


Mac Source Code CD-ROM 

Apprentice 4 
is here! 

7f r s wonderful. It's saved me probably 20 hours of time 
in jtist the fast week. It is well worth adding to your 
collection, definitely one of the most useful CDs in my 
collection/* 

- Peter Lewis 

Over bSfl megabytes of high-quality and up-lo-dale Mac only source rode from 
hundreds of programmers, if you’re looking for great source code examples, flits is the 
CD-ROM for you. A It of the source code examples are new and u pdal ed i n this release! 
Apprentice source is mostly C r C++, and Pascal, using CodeWairioi, Symantec, and 
MPW. Includes examples of applications, games, code resources, control panels, 
system extensions, plug-in modules, hundreds of snippets, and much more! 

$35. Upgrade from any previous Apprentice retease for only $251 

Shipping included tor U. 5 , and Canadian orders. Add S 5 for shipping outside the tl$, and Canada. 

Visa, MasterCard, American Express, and Discover gladly accepted 


Celestin Company, Inc., 1152 Hastings Avenue, Port Townsend, YVA 98368 
800 835 5514 * 360 385 3767 * 360 385 3586 fax 
Internet; celestin@celestin,com * http://www-celestin.com/ 
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TASTES LIKE CHICKEN! 




Without secure software, even the most expensive 
hardware key is nothing but a chew toy. 


Protection is only as effective as the software involved. Most hardware key 
vendors require that you, the developer, spend major resources protecting 
and obscuring the code which interacts with a key. Without this effort on 
your part, your software is vulnerable, even to inexperienced hackers. 


At PACE, we understand that software is the most important 

component of a working protection system. For more than a 
decade we’ve developed low cost and secure software bused 
protection schemes. Our MacEncrypt system will mm key 
protect your application automatically, applying multiple layers of PACE 
proprietary encryption and seif checking algorithms to your product. 

MacEncrypt is a secure, flexible, compatible and low cost protection 
investment. No false promises, wasted development time, upset users 
or expensive chew toys. 


Trust the protection of your software to the people who understand 
software. Call today to order your PACE Developers Kit. 


PACE Anti-Piracy 1082 Glen Echo Ave. t San Jose, CA 9512S 
Vox: (408) 297-7444 ■ Fax: (408) 297-7441 • AppleLink: PACEA1 1 
email- infb@paceap.com * Web page: http://paceap.com/pace.himI 


You need to protect your software Hardware vendors will try ro convince 
you ( hat hardware keys are die only secure method of protection. 

I hey 1 re wrong. 



PACE 


A n I I - P 1 R A C Y 

VurJapanese font supplier impi 
strict copy protection obligator 
on Adobe Systems. Because of tb 
we have been using PACE softwa 
protection on Adobe Type Manag 
Japanese version and our othe 
Japanese font products for alma 
5 years. PACE's software solatia 
provides us with effective security 
a tow cost \ Our working relations 
with PACE is excellent and 
their expert technical staff ha 
always been helpful 11 

Paid Anderson 
Senior Director, Pacific Rim 
Adobe Systems, Inc* 



68K and Power Macintosh versions 

•full ANSI 77 native compiler 
•faster execution speed 
' graphical source-level debugging 

• two complete graphics packages 

• make utility, MRWE application framework 

• System 7.5 compatible, MPW included 

• Windows 95/NT version also available 

absssft 


Visit us now at http://www.absoft.com 


2781 Bond Street Rochester Hills MI 48309 * (810) 853-0050 * Fax (810) 853-0108 ■ sales@absoft.com 
































Spare your fingers and find the full list online at: 

http ://www. m actech .c om/U R Li . htmf 

Or l (for a limited time), send mail to; 

MacTech-URLs@dass.com and you'll receive the latest list hack. 

Latest Updates 

Internet Related 

Concensus http://www.consensus.com/ _ 

Excire Mel search http://www.exGte.com/ 

3 on Pugh h ltp://rw,ct5 com/ - jonpugh/software/Hyper card/ LI RLs.sil .hqx 

IopSoft {I n terne t U ser's Group ] http://www. topsoft.org/ 


Other Programmer Resources__ 

Club Macintosh de Queb ec http://V ww2.zone.ca/- cmq/ __ 

Everything Macintosh http://www.es.brar ideis.edu/-x ray/mac.html 

Robert Lentz http^/www.astro nv^edu/lentz/mac/ 

Program mer's C hal fen ge h t ip://www. madech .com/mail I ist,htm l#prog- challenge 

Vendors, Products and Miscellaneous 

Cydos http://www.cycfoi.com 

Entertaining Macintosh http://www.fen.bris.aGuk/students/am4001 /matgames/ 

see dls<> http://www.princeton.edu/-pfcreath/macgames/ 

JYACC http://www.jy acc.com/ ____ 

MacVon k h ttp://www,cci net. a b ca/m acvonfc/_ 

MacWay mailing list mailto: Sistproc@abs.apple.com 

in the body of the message pul; subscribe MAC WAY your name 
Mac World htlp://www. ma cwor Id .com / 

Play it again Mac http://www.phl.tom/macpages/name_me.html 

Hilights 

Internet 

Architext is a small company (.started by six Stanford 
students) who have some interesting text indexing software. 
Their software tries to index based on concepts a.s well as 
keywords. To demonstrate their wares, they’ve taken to 
indexing the World Wide Web and making their database 
available. Cheek them out and try searching for some concepts. 
Excite Netsearch http://www.excite.com/ 

Jon Pugh has created a new Ixiokmarking HyperCard stack. 
This free program can help you keep track of your URLs, 
especially if you end up with lots of them, as I do. 

Jon Pugh http://iw.cts.com/-jonpugh/software/Hypercard/URU.sithqx 

Macintosh 

For those of you who would like to read your Macintosh 
news in something lieskles English, I suggest the Club Macintosh 
de Qudbcc. This site is a French-Canadian Macintosh users group, 
and they have nicely organized a lot of Macintosh information. A 
gixxl source for those whose French is better than their English. 

C!ub M ati ntosh de Q uebec http://www2 .zone.ca/ - an q/ 


Here's another huge index of Macintosh resources. Nathan 
Raymond has put together quite an extensive list of information. 

Everything Macintosh http://www.cs.brandeis.edu/-xray/mac.html 

We’ve all known that Rotxm Lentz has a great site for Mac 
developers, buL recently I’ve been looking through some of his 
otlier pages. lie's done an equally outstanding job with lots of 
information of interest to anybody with any interest in the Mac. 
It's time to check him out again. 

Robert Lentz http://www.astro.nwu.edu/lentz/mad 

I’ve come across a couple of sites about gaming on the 
Macintosh. While we await the Pippin machine from Banda i Co. 
Ltd., you can see what's new in gaming on the Mac. There's lots of 
information on lx>ih shareware/freeware and commercial games. 

Entertaining Macintosh 

http: //www. fen. biis .a c. uk/stud en !s/am4001/matga mes/ 

see also http://www.princeton.edu/-pjcreath/macgames/ 

Play it again Mac http://www.pht.com/macpages/nanie_me.html 

Guy Kawasaki has another mailing list he's running. 'Hits one 
is more evangelism than Semper FL bin if you're trying to sell to 
the Macintosh community, it would be a good resource to track. 

MacWay mailing list mailto: listproc@abs.apple.com 

in the body of the message put: subscribe MACWAY your name 

Finally, if you’re interesting in the monthly Programmer’s 
Challenge, you can join our mailing list of discussion relating to 
die challenge. Our mailing list web page as a form to allow 
you to subscribe. 

Programmer's Challenge 

http ://www. mactech.com/mai I-list, htm I# prog-challenge 

Neal non-Macintosh site of the Month 

If you didn't know, people have been putting cameras 
around and posting the pictures on die Internet. Normally a 
camera is set up to Lake a new Image periodically (every 5 
minutes, for example) and the picture posted. Cameras have 
been set up overlooking a golf course in Hawaii, in an elementary 
school classroom, looking at a fish tank T and any number of 
people offices* For a fairly complete list, check out this page. 
Cameras, Cameras, and More Cameras 
http://www . i n tert a i n , n et/ -came r as/ 

Well, that's it for this month. As always, if you find 
something interesting, or have updates, send them to 

U R Ls @MacTe ch. com 

Thanks this month to Christopher Allen, Bill Goodman, Robert 
Lentz, Jon Pugh, Nathan Raymond, and many others for their 
attributions for their suggestions and [jointer* to new and old sites. 
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DIALOG BOX 


By Matt Neuburg, Managing Editor 



Brim, Back the Good Oio Days 

1 am an entirely self-taught, l^y now intermediate level Mac 
programmer (unabashedly Pascal - CW t though l still utilise 
Think Pascal 4.0,2) who enjoys MacTech very much. J have 
been reviewing and teaming a great deal from your back Issues 
from the "distant* past! Nevertheless, I do have certain \yecfe. I 
am somewhat disturbed by the trend to feature to such a great 
extent the more technically advanced aspects of programming 
understood by the lew, from which the rest of us can learn very 
little. I'm afraid. In the past there was a certain gleeful joy 
about programming, a certain spirit and amazement and 
perhaps naivete about it all that seems to lx missing now. Hie 
magazine seems too severely oriented to the well-equipped 
professional, with an insufficient amount of time devoted to us 
weekend, sparetime adventurers. 

Additionally, far too much space is given over to Symantec 
and not enough to Mctrowcrks, And there is just too %a&* 
much C++. As a “Pascallian", 1 read a lot of C and adapt ii to 
my needs, C++ is impossible, and I find it very hard even to 
follow the basic ideas being presented, 1 know that you cannot 
force people to write articles in any one language (and I know 
that C++ and C for that matter aren’t going to disappear), but it 
would be great if you encouraged authors whose articles are in 
C/C++ to make sonic effort Lo put the PascaJ/OP counterpart in 
a parenthetical or a footnote. At least some effort ought to be 
made to explain the less obvious portions of the C/C++ 
program code by pointing out various things that Pascal 
programmers should be aware of and by offering possible 
Pascal/OP solutions where that is possible. After all T as was 
noted in the November issue somewhere. MacTech is the only 
programming magazine for the Mad Efforts should he made to 
include more of us in the challenge that is Mac programming. 
1, for one. don't like feeling left out for no good reason. 
Thanks. 

- Jeff Niederhoffer 

Ijcff ; I sympathize strongly with your plea. At MacTech, we re 
looking to extend ourscofw to include once more those “weekend, 
spare! i me adventurers”- wit haul of course, losing our edge as a 
forum for the professional deuetofwr community. Of course, 
sending its the articles is up to you, the readers! - Ed. maul 

/As for your comments on Symantec vs. Metromrks f please take note 
(in this issue) of the introduction of"From the Factory Floor - our 
new column to give Metmuerks a presence in the magazine. You 
should exfxxi lo see this as a regular feature and you should take 
pride in knowing that you, the readers, made it hapfxm - FA, nstj 


Apple Missing rrs Chance to Rewrite the OS 

Scott Boyd hit the nail on the head with his comments, in the 
November issue of MacTech, about overcoming limitations. 
Apple has made a tragic mistake in the way it is handling 
compatibility with Copland. The legacy code of Apple 
continues to grow, with all its limitations. It is very sad that 
developers are constantly faced with constraints that could have 
been built out of the system years ago. 

Apple needs to look at the OS and see that when a machine 
has 8-16 meg as standard, 32K worth of text (or less if it's a big 
font) is ridiculously small. Apple lias also recommended that we 
avoid creating too many resources (I can't recall the exact figure, 
but 1 believe it is in the 2K range). In Apple's words, M The 
Resource Manager is not a Database*. My question is: Why not? 
Why can’t we have a 10,000 entry file that contains 60K of text 
that can be written in a few lines of code? Why do we need lo 
do linear searches io find a resource? 

How could Apple have fixed these problems? One obvious 
way might be to create new Managers with new APIs, I’m sure 
developers would flock to such managers. While this would 
work, I think Apple could have done something more radio! to 
rid itself of all this legacy code. 

Apple could have created Gershwin from the start, a real 
multi-tasking OS, For compatibility, it could create a virtual 
System 7 machine, much like MS Windows creates a virtual 
machine for DOS programs. This could have been a single 
thread in Gershwin that emulated a System 7 environment, with 
68k emulation and all. Gershwin programs would lx 1GG% 
native, running on a pre-emptive native OS. If you need to run 
System 7 software, you have that too, The toolbox APIs could 
be completely rewritten, no constraints required. Likewise, 
Apple could have written a new file system that fixes many of 
the limitations of HFS. The File System Translation Manager 
would support old “inferior" file ,systems, much in the same way 
as we can read and write DOS disks, 

Of course, we know none of this will happen. And 
unfortunately, it also means that we won’t see a truly pre¬ 
emptive MacOS lor at least 4 to 5 years. Boy, dial Mac will be 
great in the year 2000; I can't wait. Don’t get me wrong. 1 love 
my Mac. It is just disappointing that Apple has stumbled so 
much for so long. 

- MarkMunz, hippy /)qg Software 
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Are your 
projects eating 
you alive? 


Arc your projects eating you alive? When time is of the essence the quality of the people and their 
work means everything... 

Swill performs above the standard level. We understand that experience, timing and costs can mean 
die dill'ercnce I dr a successful project. Wlien you need a person or a team to make tilings luippen. 
call us. 



We have provided solutions from the firmware level up. We work with the latest technologies such 
as Oracle Power Objects, OpenDoc/ODE & Java to bring the latest options to solving your problems. 
Our technical services include Project Management. R & D, Training and Technical Support. 


Swift can make die ditfcrcncc. 
Tosee how. call (408) 338-1464. 


SWIFT 
- o - 

CONSULTING 

610 Wes I Dr, 

Boulder Creek, CA 95006 


© 1095 Swill Consulting, Inc* 
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File express 

e 

Scriptable Mac-to-Mac document 


transport tools for both TCP and 

W\ 

AppleTalk networks. Yes, both! 

& 

If you crave the ability to send files or 

3 

folders from within your own Mac 


based solutions or applications, then 

0 

File express is the tool for you! 



File express Features: 



• AppleTalk and TCP/IP Support 


* Built-in Compression of Files 



* Fully Asynchronous Operation 

& 


* Recordable & Scriptable Engine 

IH 


* Store-and-Forward Extensions 

JC 

* * 


And all for just $20 per license! For 

V? 

more information contact us at 

m 

Ruskin@eWorld.com, or download 

9 

our demo from your favorite archive 

OC 

or on-line service. Yowza! 



criptWizard 


Version 1.5 


Now shipping. With ^11 the new Features that you asked for. 

Script Wizard™ is the best-selling OS A/AppleScript script-editing 
and debugging tool that combines the power of a professional 
development environment with the ease of use that you expect of 
Macintosh® software. ScriprWizard improves your productivity by 
delivering testing and debugging facilities that are as intuitive as 
they are powerful, including a Variable Watcher, true single-step 
debugging, rapid script navigation, and more. 


New features.*. 

* True AppleScript statement—level single stepping. 

* Scriptable and Recordable. 

* Improved text editing, with drug and drop. 

* "Native" lor both Power Macintosh and 68K. 

■ Quick access to Dictionaries from a new menu. 

* Full control over Toolbar position & visibility. 

* Re-sizable panes in windows. 

* Projector-aware lor source code control. 

■ Edit and debug scripts for EaceSpun 2.0. 

* and much, much, more... 


Upgrade 

$39 

US price 
still only 

$99 



US Orders: 800 433 4989 

Tel: 510 H4J 648+ Ala., sold by APDA Si Mac-Tech. 
Full Moon Software. Internet: *sales©fullmoon com' 
International Orders: Tel +44 1628 660242. Fax 666084. 




: :: * - - , - ■ * * H ' " - * ~ ^ * 

^ --i-Tdi 3 feL b 

sza f f -- , * * 1 *w«n*w*r*#* * 'f 

lepers at Mat Hack arc one of (lie important 
parks of the conference. Some of the papers 
that b Me been presented in the past are: 

7Mj uf iimtikilhu: WK m PothrfC 

Mafyig Mmi&htn: A Yoke itecogmUm Toolkit ftp- Macintosh Applications 
(pimfcmg Source 0‘nk - (idfing the most from your Mite 
Atmlinv hmcimims and Other CrmiHatform 
treating a Consistent JD interface 
the Design o f Interactive lUevtsion AppUcaticw 
'the Macintosh m m Internet Server 

If you have a way-cool application, 
a new technology or new way of doing something, 
or a good tutorial on present technologies and how they work, 
we want a paper from you. 


Abstracts are required by February IS, 19%. Please submit them to: 

]o<i^itol.com with a subject field of "MacHack Abstract" 
Corresjwndeiice encouraged 

M.i lliiid'i mi«I SiWlili wi' It Pjini iti.li ki i4 A|qrir I jiii||iij1h All irllu'l llmli'iuiit', ijw pm^irfh id llirlr U»-tL*b h ;[ Ini- 

i cm Hi uf KijWIMl, Iflf NH iUYiHdlod vi#h IIk Madia*™ timi^ ,411 fijtlits tftuwrf 


DKVHLOPTJt 

% 

UNnosrrY 


It’s not just the basics anymore ! 

Advanced courses from Developer University 
get you up to speed quickly on new Apple lechnoiogiess 

□ OpenDoc 

□ PowerPC 

□ Newton 

□ Graphics/Imaging 

□ Apple Guide 

Courses Available as 


•fi 


Self-Faced Classroom Lecture Online 


For more detailed information, cheek out our World Wide Web pages, 
httpc'/www.info.apple.com, or contact the Apple Developer University Registrar 
at (408) 974-4897 or fix (408) 974-0544. 

Dcvdopcr Unfoerelry, Apple Computer, Ine. 1 Infinite Loop MS 305-1711. Cupertino. CA 95014 
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From idea to delivery... 


Dilbert by Scotl Adams 


I'D FIX IT HY5ELF 5UT I 
KNOW 1TTAKE5 SPECIAL 
TOOL5 . .. 



PLUS l WOULD TU5T 
HAVE TO ORDER A 

part... and rn 

PRETTY BUSY... 




1 


$ 

I 


i 



Complete 

Software 

Duplication 

Service 

800 - 222-6032 


Softwiiir Diiplii .itinii ♦< I) KM VI 
• Awrmbh 

I’riiiling ♦ Tiii kagiiiK * Shipping 




/ « st i 

/ 

o 


all handled with top 

QffAWn ... StiRVICI I... SPl'MO 


Aatiorizfl . 

For 11 Years! 


ImerrurmhLil Dataw^its, Inc 
227H Trail* Zone Blvd 
San }osc • CA 95 lit 
(44K)2&2'*660 
Fax; (•HIK>262-890A 
IliU rtieU itl ikds^ual.Lom 




Can you spot 
the difference? 


Plenty of |people ant Because wltether you uptime software with a 
full sel of program disks, or a file mack* with H|xlateM;*ker 2.1 Ik* ri*sull 
is [lie si me Guaranteed l ptbieMaker Ufxhtes art* kit ally reliable 
tLs system of 324>il dieeksuiTK ensures that it updates the njL*li1 file. 

And UpduteMaker is easy-to-use - simply specify ihe files and 
update Maker builds the update. Then: is no scripring wr list* of 
KesHdil lt\ even easier lor end-users - just one hu It on to press. 

I ipdateMaker 2 works with any type of Macintosh Ilk* t he updater 
files are extremely compact And Lite program options numerous 
You an presene or override user uistoimotions. Save files in tfmhex 
format. Update up to 20 old versions with otic file. 


The real difference is the savings in time and money Which 
explains why some of the Jtat-kmiwn nanx*s in software 
development have already discovered UpdateMaker 2. 



Distribution Is unrestricted and royalty- free* 

Only $225, order now, fax (415) 964 2886 

Applelink^MaetabOU" IrUernetjMat.TiibOO - '#Apple! ink. tppkM iMii 


UpdateMaker 2 


ADLismimeriJs, 122% Grant Road SuJtC *4, los Altos, CV 94024 Phone: (415) 9*>4 28^8 
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Training 

MAC INTOSH Sf MINARS CONSUl T1NC. ^ 


44 


Richey Software Training provides 
prt jfess j r jnal, custom ized prtigra m m i ng 
[seminars and industry consulting. 

Rich content & hands-on lab 
exercises shorten your learning curve 
On-site training is convenient — your 
l ea m d I m f nates ex pcns i ve t ra vd cos i s 
and cc>nsii m i ng dc jw n-ti me 

Pro/^/ond/ training & consultancy aa 
lha t t eaIty h its the nut rk 7 7 

Call today to find out how Richey 
Software Training delivers professional 
seminars and consulting nationwide 


MAC 

SEMINARS 


-t;&c++ 

-1X >M 
' MjiCApp 

• PowitI^C' 

- A[v|>UStftpt 
■ MPW 

^SysIt-mT 

* nrhqggjng 
•StHiru'iUig 


RICHEY 

fi 


Train in* mjc Programmen sine* 1 !■*»<* 

707 * 869*2836 

Aniiio.ink, itvcirKVAdFr 
I NTHRNFT T<MUJ7K>«i iwtipuM’rw. .*ni 
rn »M*\ m*> i .pfkm:\ii l l i-A ‘rtHMHi't 


w Developer Tools to Support 
Adobe Adobe™ Technologies 

Adobe provides a complete set of tools and 
services for your development needs. Whelher you 
wont to integrate Adobe Acrobat™ capabilities into 
your applications, add PostScript™ language 
supporl lo your products or creole powerful 
Graphics Application Plug-ins, Adobe has the tools. 

These Software Development Kits now available . 

► Adobe Acrobat™ Plug-ins 

► Adobe PostScript™ Language 
^ Adobe Photoshop™ 

^ Adobe Illustrator™ 

^ Adobe Premiere™ 

^ Adobe PageMaker™ Additions 

^ Adobe Fetch™ Content Publishers 

To have information faxed to you, call [206] 628-5/3/ 
and request documents ] 220 and 1233. 


Adobe Developers Association 

1585 Charleston Road, Mt. View,. CA 94039 


m Script Debugger 

Script Debugger is a powerful and flexible AppleScript™ authoring tool that makes 
it easy for novice ami experienced script writers to get die most \nm AppleScript 



Script Debugger 

■ Odets true singkrstep execution of 
ol AppleScript scripts 

■ Provides o powerful stripling environ- 
menl dial includes Drug Sr Drop editing 

u Is Power K Native 
m Is script able end nltodwible 




'...the program [Script Debugger1 
is a solid performer, and its support 
for targe file sizes, helpful 
Dictionary window, superb scripting 
additions and complete saiptability 
make it a wry good choice,’ 

Avi Rappoport and Ed Allen 
Afar WffJT Magazine 



Late Night Software Ltd. 

* T OO Voice l*M) 929-557B 

l£*T Fuji [bM] 929-4961 


Email glubin&'wimsey.coni 




Becoming a Macintosh Service Provider continued from }>a%e 59 


of one to two hundred per month. About 900 listings are 
currently searchable. Some other Internet experiments and 
surveys indicate that ;ls many as 5000 Mac OS WWW servers 
may be publicly available on the Internet. If automated 
techniques being developed here for listing them work, the 
number of .servers in the listings will grow dramatically before 
New Year's Day 1996. 

The STAR Site 

In an attempt u> help focus attention on some of the best 
sites, a STAR site was established to feature a Mac OS site every 
few days, and this is the second most popular page ar the site. 
The New Servers listings page is the most popular so far. 

list your Mac WWW sites, public and internal! 

If you're considering establishing a Mar OS WWW site, take 
.some time with these listings. If you have at least one Mac OS 
WWW server, list it! We ask that those who have internal WWW 
servers, but who still wish to participate in the Mac WWW Server 
community, list their URL as “internal site/ so LliaL NetScape will 
report “...cannot connect to server... interna! site,.." In this way all 
Mac webmasters who w ish ro can show what they are doing with 
the technology, and meet and work with others who are 
attempting similar efforts, whether public or private. 
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Tips & Tidbits continued from page 112 


InitGraf( fcqd.LtiGPorL )? 
lnitFontsO : 

InitWindavrsO : 

InitWeaus(); 

TElnitO; 

InitDiala&£( OL ); 

InitCurRor £}; 

KaxApplEonoO ; 
j // aid fniiThcMnc 

static Boolean OetAHlet FSSpecPtr file ) 

SFTypeiist types: 

StandardFileReply reply: 

SlandardGctFJ 1 <? [ NlFT^r* 1, types, fcreply }; 
if ( reply.uftiyod J 

BlockHoveC &xeply.sfFile, file, sizeoff FSSpcc ) ); 
return reply.siCood: 

I // end Get Alik 

void tnainF void ) 

I 

FSSpec sre FilcS pec; 

OSFrr thcKrr “ noErr: 

InitTheMacU ; 

if ( GetAFiief SercFileSpec > ) 

theErr - FSpTrastiFilei AsrcFileSpec ); 

I //end mum 

foncHT //TBT_THASH_f1IF 



is a collection or five menu defini¬ 
tion resources (MDEFs) that you just 
paste into your project’s resource file. 

Build a menu using the MDBF and 
then just handle menu selections like any 
normal menu. 


Ml ... 

►j 

r Him * 

► 

(iVtM t hart 

>1 

iiuv Vt'rti 

> 


Also contains Maitre d\ a special menu devehment tool 
that assisb you in designing your MENU MILL Menus. 



• Use your drawing programs as programming tools 
■ Fast unobtrusive RGB color picker 

• Space saving Geneva 9 MDEF 

• Calander Menu 


mt ..$69,95 


Write, Arid Publishing, Inc. 
11A leisure Time Drive, 
Diammulhvad. MS 39525 
Call (mi) 255-0713 
FAX (601) 255-7086 


DR vet.(>n:i> nv via/, son waki . inc 


Visit MacTech Magazine’s Web site! 

http://www.mactech.com 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

productinfo@xpiain.coni 



Bug Tracking the Macintosh Way 


TestTrack automates and simplifies tracking your bugs so you 
ran concentrate on fixing diem. Easy 10 set up, easy to use, 
and quick too! 

it Track bugs, change requests, testers, 
configurations, and more 

& Pttxiuct* concise reports 
& Automatically route bugs to team memlsers 
® Minimum setup time 
£ Multiple users, full security 


Bof mate infoiminati, nil nr vrurl e-rmil inw^pir* net 


£ 


Seapine 

Software 


Srapinr !>wJlwarr. IPT, 

106$ llejpinc Court 

wiKrtk.QUfm 
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MacRegistry O 

Developer Job Opportunities 

If you arc a Macintosh developer, you should register with 
us! We have it database that enables us to let you know about 
job opportunities. When we are asked to do a search by a 
clienl company the database is the first place we go. There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide. 

Marketability Assessment - To get a specific fed for your 
marketability send a resume via Email or call. You may also 
request a Resume Workbook & Career Planner. 

Discreet We arc very careful to protect the confidentiality 
of a currently employed developer. 


Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place¬ 
ment services and we are Mac fanatics. 


1*800-231-5920 • das@spi.com * Fax 1-800-757-9003 
h 11 p ://ww w .sc i enli lie xo in 


Scientific Placement, Inc 




M I, Uni I 'W) r Hmutnfl. I X 77214. 711-496-6100 Pm: 7134964H71 

Ml, Ifiis 71, Kah k.iim.iHL CA1RSX3 MU-733-6168 brthWtpiL'Ji.kvJl.ixwi 

M l . H in 202676. Atnttm, TX 78770-2676 512-260-0123 lej@ulkn.net 

MT. KwmiK Sun Kill, fttn 13225. MA 02215 617-424-8372 pn.uutm 

Af^ilfLuik DJ 5KU, CiJiiipuwrvi;: 71250300] ; cWurfd ^ AOL' davt^trau 


J 



iTIATTKER NETWORK 


COMTUTCR CONSULTING SERVICES 

T he Trattner Network (TTN) is looking tor experienced 

Macintosh developers tor cutting edge opportunities in Northern 
California and across ihe country 

T TN represents clients whose projects lor consulting and Full 
Time Employment include development in OpenDoc, 
Cyberdog, Copland* Newton, PowerPC, Metrowerks, 
MacApp. and many others. 

p^j OW— The Trallner Network has urgent needs for: 

* Software Developers • Hardware/Firmware Engineers 

* QA/QC Professionals * Project Coordinator/Managers 

* Multimedia Developers - Network Professionals 

The Trattner Network has a unique history in Mac consulting 
coupled with exposure to emerging Technologies If you are looking 
for a chance to enhance your skills and marketability, 

please send, fax* or fink your resume to: 

The Trattner Network 

Attn. Emily Hoolhorsf 

170 Slate Street, Suite 240 * Los Altos, CA 94022 
Phone 415*949*9555 ext, 115 ; Fax: 415*949*1026 
AppleLink trains!; E-mail emily®tratnet.com 

THE DIGITAL TALENT SOURCE 


MACINTOSH SERVICES 


Publish Your 
Software Free 

United Software Exchange 
will market your software 
nationally at no cost to you, 

Interested? For no obligation 
information email Ralph at 

USoftEx@ aoLcom or 
call (70S) 582-7465 


-M- 

U l E 

United SoftwareExchangf 



The Classifieds 


"Object Oriented Code? 
Sure, between rides!" 



Macintosh 
Prof rammers & 
Adventurers g 
Wanted 


- MiilpcfH 
ftifraai 
hit w*jr 
t a w«rh 


M a cXperts is 

a software 
development 


ate 

for Macintosh 
programmers with C. C+ +. or other 
Mic programming experience. 
Take (he first step to adventure. 
Call Michael Bottle at: 


1-&0Q-356 S04d or f« f $04 JSi l$47 
intrad: iprlpinfi.ift 
AppleLink: ■ peril AOL: NUiXparU 
http ^Mww Hid peril - M*V - * p** < 


MindVLsion Software 

(a>-atiihor5 of Speed Doubler) 

wants to pay you well, 

insure you and your family, 
give you lots of vacation time, 
great equipment to work on, 
great people to work with, 
listen to your ideas, 
and help get your name in the 
credits of some of the 
must successful products in 
Mac & PC history. 

We ask only that you try as hard 
for us as we will try for you! 

If you want to team up with a 
great software company contact 
(iru Id B eMe (a) mind vi sion cl im 
Various positions available... 


Mac Tech Magazine 
is your 

recruitment vehicle 

When you need to fill 
important positions at your 
company, MaeTech Magazine 
h Ihtf consistent choice of 
companies across tl>e country 
for hiring the best qualified 
Macintosh programmers and 
developers. Let MacTcch 
Magazine deliver your recruit^ 
ment message to an audience 
of over 27*000 qualified 
computer professionals. 

Call Ruth Subrin at 
805/494^9797 
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0? [NTKRACflf?! 
ENTERTAINM ENT 


Westwood Studios has Command & Conquer, 
openings for talented Monopoly, The Lion 

Macintosh Programmers King, Dune II, and The 
to work in-house. If you Legend of Kyrandia. 
have 3 years experience We offer competitive 
coding C/C++ on the salary and bonuses, an 

Macintosh, we’d like to excellent benefits package 
heai from you. and a challenging work 

We are currently environment. A move to 

celebrating our 10th year Las Vegas means no 
of leading-edge games state income tax, 
development. Our most affordable housing and 

recent hits include outstanding scenery'. 

MAC PROGltAMMSM 

For confidential consideration 
please send your resume Attn: Elsbeth 
Westwood Studios 
533,3 S. Arville, Suite 104 
Las Vegas, Nevada 89118 
fax (702) 368-0677 • phone (702) 368-4850 
email careers@westwood.com 
website h ttpd/www.westwood. com 


Got Software for Sale? 


No Advertising Budget? 



Try listing your product in MacTech Magazine’s Mail Order Store 



Classified Advertising at %cost effective rate! 




For more information, call, lax or e-mail: 
Voice: K0V494-9797 • Fax: S0V494-979K 
[ nternet: marketing@xplain.com 


far Uminlush 
Frugrnmiurcs G Developers 
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By John Kawakami, Mat Tech Magazine Editorial Assistant 



Yet Another Platform for CodfWarrior: Java 

Metrowerks, the leading provider of Macintosh development 
tools, today announced ihai it will provide a suite of java™ 
development tools, code-named Wired, for the Macintosh 
platform. In addition, Metrowerks announced iL intends to ship 
the first developer release of the Java tool suite in May, 1996. 

The combination of Java, GpdeWarrior and the Apple 
Macintosh makes for a powerful Internet development solution. 
Sun’s Java allows Internet sites to fully incorporate motion and 
sound, real-time information updates, and user customization 
and feedback, Apple s Macintosh family of persona! computers 
is heralded as the multimedia development platform of choice, 
with Dataquest estimating 63% of multimedia content is 
developed on the Macintosh. Metrowerks’ CodeW'arrior product 
line is the market-leading development environment for 
Macintosh, and is widely credited as a key factor in enabling 
hundreds of Macintosh developers to make a quick and easy 
transition to the RISC-based Power Macintosh line. 

Using Java, which is syntactically similar to C++, developers 
can write custom mini-applications called applets. When 
Integrated into Internet web pages, applets can enable expert 
graphics rendering and real-time interaction with users, live 
information updating, and instant interaction with servers on the 
Internet. Applets are downloadable from any server and run 
safely on any platform, 

Metrowerks will provide full Java support in its Macintosh 
hosted CodeWarrior products. The company anticipates that 
the first developer release of Java for the Macintosh will lx: 
ready for Code Warrior 9, which is expected to be available at 
Apple's Worldwide Developer Conference in San Jose, 
California in May 1996. 

Metrowerks: 

mailto://info@metrowerks,com 

http://www. metrowerksxom 

Sun: 

http://java.sun.com 


Appij-’s Now Has Creator Code Registration 
on the World Wide Web 

If you haven 1 ! been registering your type and creator codes with 
Apple because their HyperCard based registration system is out 
of date and inconveneint, well, you now r have no more excuses. 
Apple has put Lyjx and creator registration forms on the web, 
and registration is faster anti more convenient than ever. Fill 


out the form anti submit it to Apple, and you receive a 
confirmation or denial of your request around 48 hours later, 
Also at this website, Apple has also implemented a 
searchable database so potential registrants may verify that their 
choice is unique. Developers can search up to sixteen codes at a 
time to see if they have been assigned. Owner information 
related to the codes, such as company, contact, address, phone, 
etc*, is confidential. Also available on their web is general 
information about registration and other creator code related 
information, 

A form to register your file type and creator codes: 

http://dev.info.apple.com/cftype/main.html 
A form to search the database: 
http://devinfoapple.com/cftype/find.html 


Apple Delivers OpenDgc for Mac OS, on Schedule 

Delivering on its promise to complete the development of 
Open Doc component software technology in 1995. Apple 
Computer, Inc. today announced the availability of the 
OpenDoc for Mac OS Software Development Kit (SDK), which 
contains the completed OpenDoc software as well as sample 
code and tools for development of Open Doc-based solutions. 
Demonstrating their support, 300 software developers who have 
been working with early versions of the SDK, made 
commitments to deliver Open Doc-based components to their 
customers in 1996. These commitments mark the beginning of 
the evolution toward component-based software aimed at 
making computing easier for all users, 

u 13y shipping OpenDoc, we vc taken he first big step toward 
the next generation of fKTSonal computer software/ said David 
Nagel, Apple's senior vice president of worldwide research and 
development. "As Apple and others make OpenDoc-based 
solutions available in 1996, computers will become more easily 
customized for the needs of specific users, and well see small 
innovative software developers returning to the software 
business. And because OpenDoc is created by an open alliance, 
computer customers will get more freedom of choice and won't 
be tied to the arbitrary decisions of a single company.” 

Apple plans to deliver the OpenDoc technology to its 
customers as part of the Mac OS, through hardware bundling 
and in component-based products throughout 1996. Apple 
also is actively incorporating OpenDoc technology into its 
system software. 

The OpenDoc for Mac OS SDK includes OpenDoc system 
software for Power Macintosh and 680x0-bascd systems, sample 
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code, full documentation, and a .set of development tools. Apple 
also plans to deliver versions of Open Doc in 16 additional 
languages in early 1996. Developers can download the entire 
SDK beginning on November I0 f 1995 through the World Wide 
Web at http://www.opendoc,applexom or send email to 
opendoc@apple.com to receive a free developer CD by mail. 
[There unit /x j a copy of the OpenDoc 1.0 CD in the February issue 
of Mac Tech - watch for iff Pub. mtj Developers can also 
download additional development ux>ls from Apple, Merrowerks 
and Symantec, including a pre-release version of Apple's 
OpenDoc Development Framework (DDF) for Mac OS, 

Component Validation Services 

Cl Lalis, the vendor-neutral industry association for 
distributed component technologies, last week announced its 
plans to roll out component validation services in the first half 
of 1996, These services along with an accompanying logo 
program will deliver on the promise of interoperability that Cl 
Labs has pledged to provide, 

The Promise of Cross-Platform Component Software 

The availability of the OpenDoc for Mac OS marks the first 
of four platform implementations planned to ship over the next 
yean In addition to Apple's plan to deliver OpenDoc 1 for the 
Mac OS, IBM Corporation has announced plans to deliver 
OpenDoc for AIK, OS/2, Windows NT and Windows '95. 

OpenDoc Support Grows 

More than 300 developers have stated their support for 
OpenDoc for Mac OS and their intention to deliver products to 
the market in 1996. This list grows daily as an increasing 
number of ISVs see the opportunities to use component 
software to deliver innovative products to their customers. 

Interspersed among the 360 well known and unknown 
companies planning to support OpenDoc are a handful of 
unlikely OpenDoc developers including the following: Kinko's 
is a US based chain of photocopy shops; Pac Hell Directory 
publishes yellow pages phone books; Viacom is the media 
giant that owns the cable network, MTV; and Virtual World 
Entertairnncm runs a chain of "virtual reality" entertainment 
centers where you go into a fake “cockpit", complete with 
switches and lights and a big computer monitor, and wage a 
simulated Robotech/Battlemech war on your friends. 
OpenDoc VR? 

The complete list of committed companies is at: 

http;//www.apendoc.applexom/committed.html 

Tile very attractive OpenDoc homepage, where you may 
download OpenDoc and the ODF, is at: 

http;//wwwxpendoc.applexom 


ICON IX Debuts Object Oriented Methodology 
Tr aining on CD-ROM 

Longtime object oriented programming tools developer and 


training consultants, ICONIX. noted that programmers were 
requiring more education and training about GO 
methodologies. As president, Doug Rosenberg, commented, 

1 1CONIX has Ix-en fighting CASE tool feature wars for the last 
eleven years. A few years ago we realized that adding more 
features to our CASE uxils wasn't increasing the success rate of 
our clients on their projects, and that we needed to deliver 
methodology training directly to the desktop. 

"Our first CD-ROM training course 'An Object Methodoloy 
Overview' provides a good start in that ii helps to understand 
the big picture of CO methods in an incredibly short lime, but 
our customers have been very clear in expressing their need for 
'on-line methodology help 1 with the same level of detailed 
insinkiion we provide in our on-site training/ 

AnLidpaLing the trend that has brought Bauch, Rumbaugh, 
and Jacobson together in an effort to unify their methods, the 
CD-ROM titled H A Unified Object Modeling Approach" offers 
extensive tutorials on the strengths of each method: Jacobson 
for user-driven requirements and traceability across the 
lifecycle, Rumbaugh for domain analysis and reuse across 
multiple projects, and Booth for detailed C++ design. In 
addition, prototyping is stressed as a requirements definition 
technique, with extensive explanations on how to derive Use 
Case and Domain Object Models from prototypes. 

ICONIX Software Engineering, Inc (ph, (310) 458-6092): 
http://www.biapxom/iconix/ 

MacHack Winner, CyberFinder, Goes Commercial 

Aladdin Systems began shipping CyberFinder 2.0, a utility 
which gives Macintosh users an easier way to navigate the 
Internet. Based on a entry to the hack contest at MacHack, 
CyberFinder is a control panel which allows users to create 
new types of Finder icons, called “bookmarks,' 1 that point to 
sites on die InLcrneL Double click on a bookmark, and the 
proper application launches and resolves the URL 

CyberFinder 2.0 sports a nifty notable feature, 14 Hot Keys", 
which will allow r users to go to Internet sites from within any 
application they happen to lx* using. Die user simply selects 
the URL, presses the IIotKey, and voila, instant gratification. 
Now you don't have to wait for your favorite email diem to 
add Internet Config support! There's also another handy 
Hot Key which will “grab" a selected URL and produce a 
fxx>kmark In a designated folder 

If you need CyberFinder, you already know it. The price 
is US$30, There's the original version ar the MacHack site 
below, and a fifteen day demo at the following: 
http://www.aladdinsys.com 
ftp://ftp.aladdinsys.corn 

The original MacHack entry was also called CyberFinder 
and is available at: 

ftp://ftp.machackxom/Hacks95/CyberFinder.sit,bin 
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Learn C on The Macintosh 
Second Edition By DaveTiSfr 

Mark Learn C on The Mn^rntnsh Stmid 
Edilion This is a completely revised 
edition o! Learn C on [lie Macintosh With 
Ibis seil-teauhitig, easy-to-understand 
bouk and the enclosed CD-Rom, you gc! 
everything you need to start programming 
in this widely used language New to this 
edition are updated and enhanced 
exercises that lead you step by step 
through the programming fundamentals 
and C language basics including function, 
variables, pointers datatypes, data 
structures, and the tile input and output. 
Also new is completely rewritten code, 
plus answers and source code tor all of the 
exercises, The new CD-ROM with 
Melmwerks Code Warrior™ Lite, a special 
version ot one of the hottcsl Macintosh 
programming environments, (including a 
PowerPC version) .mm S31.45 

Tricks of The Mac Game/j^ 
Programming Gurus is thcTsfiy 

ultimate resource for beginning to expert 
game programmers who already have 
general programming experience. Complete 
overview of alt the necessary components ot 
game programming on the Macintosh 
Hundreds of lips, tricks, and insider secrets 
Iron i Mac game programming experts on a 
CD-ROM, packed with valuable foots, 
utilities, sample code. Code Warrior™ Lite 
and game demos Coverage of cutting-edge 
topics such as QuickDraw 3D and Power 
Mac optimization and inside info on how 
Gtypha Hi was created. Unique in the 


marketplace - no other Mac game 
programming book is this complete* The 
book contains Instruction, tips, and source 
code from the top names In Mac game 
development today The secrets, examples, 
and code can’t be found anywhere else! 
These are the tried-and-true tricks that work 
behind the scenes in the most popular 
commercial and shareware Mac games. 
Throughout the book, you'll find special 
interviews with some of the most well-known 
Mac game programmers. They reveal then 
secret solutions created white they developed 
their popular games $45.00 

OOFILE is the first OODBMS 
framework to offer a complete 
solution lor application authors 
Replaceable backend database, currently 
Faimom's c-tree Plus lor cross-platform 
royalty-tree power PowerPiant and other 
frameworks integrated with edit tie Ids, 
database browsers & more. AppMaker 
users, generate complete applications 
User-friendly syntax makes it easier to 
migrate Irani FoxPro and the non-00 
world, Demo’s on CcdeWarrlor and 
AppMaker CD's $900 for a once oft e- 
tree bundle, or $1,095 1-year 
subscription HTML and character-mode 
report writer $195. Full GUI report-writer, 
including HI ML, is $495 Mac Platform 
Bundle - includes ail Mac frameworks, c 
tree, and Report-Writer. $1.495 

PowerTap “ accelerates suit- 
ware by tapping Into multiple 
processors. Version 3,9 taps into 


networked Macs and all processors found 
in the new multi-processor Macs. 
Developers can speed up their 
applications wilhout having to learn about 
networking, communications and task 
scheduling algorithms, the PuwerTap™ 
library has the easiest API - it behaves as 
a simple black box where tasks are 
submitted and results retrieved Full error 
recovery is built-in, so your fob will 
complete no matter what Power l ap's 
advanced scheduling algorithms ensure 
optimal assignments and the fastest 
execution possible. It is compatible with 
all Macintosh hardware, software and 
major compilers. Version 1 comes with 2 
remotes $1200 Version 2 comes with 5 
remotes $1900 Version 3 comes with 
unlimited remotes - $271X1 

Roaster DR1 8e the first /w 
Macintosh developer on your^j^ 
block to take advantage ot the unique 
capabilities of Sun's™ new Java™ 
Programming Language! Developer 
Release 1 of Roaster™, new from Natural 
Intelligence, Inc., is the first ever 
development environment for writing, 
testing, and running Java™ applets on Ihe 
Macintosh Features include; lully 
integrated development environment - 
protect window that includes a Finder-like 
view of packages - lightning-last - 
Macintosh native compiler - source code 
editor with powerful search features and 
intuitive use interlace runtime engine 
lor quick and easy applet testing. When 
you purchase Roaster™, you m entitled 


to: unlimited, personalized tech support 
throughout the length of your 
subscription DR 1, DR 2. Roaster 1.0 and 
one additional update. Roaster™ is 
accelerated for Power Macintosh. 
Requirements Macintosh or Macintosh 
compatible computer with a Motorola 
68020 or higher or Power PC processor; 
CFM-68K (lor 68K machines): 8MB RAM; 
Color QuickDraw, System 7.\2 or later; 
(System 7 5 or taler for 68K machines); 
CD-ROM drive to install the software 
Price: $399 Special Price: $299 

Symantec C++ is lire industry-standard 
Macintosh development system-and now 
it’s native for Power Mac You can develop 
full-tealumd Power Macintosh applications 
quickly and easily using revolutionary new 
features that save lime ami enhance your 
productivity throughout the development 
cycle. Environment includes A true native 
Power Mac implementation of the C++ 
language, including support tor templates 
and multiple inheritance; MtC/MrC+4 
compilers tor fast Power Mac executable 
code (22% (aster than with the standard 
Symantec or Melrowerks compilers), Visual 
Architect lor fast, easy GUI generation; A 
new THINK project management system 
that supports large, complex applications, 
nested projects, and hierarchical project 
organization, A new edi to (/browser that 
displays classes and automates many 
editing Junctions: A powerful, easy-to-use 
source code debugger, The industry- 
standard THINK Class Library; Free 
subscription receive the next two updales 
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MACTECH MAGAZINE PRODUCTS & ORDER INFORMATION 


K-majl, Fax, write, cull us You may use 
your VISA, MasterCard or American Express; 
or you may sent I check or money order (in 
i S kinds only): MrnTVch Magazine, PXX 
Ik)* 5200, Westlake Village, C\ 9 1359-5200, 
Voice: 005/494 9797, Fax: 805/494-9798 

If you are an e-mail user, you can place 
orders or contact customer service s_ 

• AppleLmk: MT CUSI5VC 

• CompuServe: 71335,1063 

• Internet: cu5tservice@xplain.com 

• America Online MT OJSTSVC 
■ GKftic; MACTECIIMAG 

• eWorld: MT-GusuSvc 

MACTECH WEB SITE; 
http: //www, mac tech^com 

For complete product info 

SUBSCRIPTIONS 

US Magazine: $17 for 12 issues 
Canadian: $59 for 12 issues 
ImemaUonaL $97 for 12 issues 


US Magazine with Source Code Disk. 

$124 for 12 issues 

Canadian Magazine w/Soume Code Disk: 

$136 Tor 12 issues 

International Magazine w/Source Code Disk: 

$194 Tor 12 issues 

CD* ROM 

MacTech CD-ROM, Volumes MU: Includes 
over 1230 articles from all 115 issues 
(1984-1994) of MacTech Magazine (formerly 
MacTutnrX All artide text and source code 
Now in THINK Reference formal The CD includes 
Symantec's THINK™ Reference 2.0 t working 
applications with full documentation, product demos 
for developers and more. See advertisement, this 
Issue: $49. Upgrades $39. 

K-rnatl, tail or write for info. 

BOOKS 

The Ik's! of MacTular t Vol. 1: Sold Out 
7he Complete MacTlUor, Vol. 2: Sold Out 
Ihe Essential MacTutvn Vol. 3; $19,95 
Ihe Ikfimlivv MacTntor, VoL 1 $24.95 
The Best o/MacTuior. Vol. 5: $3195 


lit*? ifMacTmor Gikxiion, Volumes 3 - 5: $69 
HeM of MacTutor, Volumes 6, 7, 8 & 9: 

Not available 

DISKS 

S< a t rce Qxle Disks; $8 ea cl \ 

Topical Index 1190461990 on disk: $5 

MAGAZINE BACK ISSUES 

Volumes 3. 4* 5,6,7, % 9 ami I to 
$5 each (subject lo availability) 

California residents include 8,25% sales tax 
on ail software, disks and books. 

Allow up lo 2 weeks for standard domestic 
orders, more time for International orders, 

PLEASE NO I L 

Source code disks and journals from MacTech 
Magazine are licensed to die pun baser for private 
use only and ait' nor to lx* copied for conunercial 
gain I lowever, the code contained therein may l^e 
included, if property acknowledged, in commercial 
products at no additional charge Ail prices are 
subjc'ct to change without notice. 
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tree when you send in your registration card 
and morel Price: $399 

Symantec C++ for 68k allows you 
to build applications tester and caster with 
the pnwerlul combination of fully 
integrated visual tools and the lates! in C 
and C++ compiler technology, C++, now 
the standard in development languages, 
provides an object-oriented approach to 
application development, and the resulting 
code is extensible, reliable, and 
maintainable. Includes: Integrated 
Environment with lull source-code 
debugging, integrated editing and 
browsing, and resource creation and 
editing; support tor standard language 
features such as templates and multiple 
inheritance as well as quick compile limes 
and highly optimized code: incremental 
Linker which eliminates long link times; 
THINK Class Library - a mature, C+4 
based, application framework provides a 
solid foundation on which In build 
factored and scalable applications with 
support for C> i exceplrons, run-lime type 
identification, persistent objects, and 
AppleEvents; Visual Architect™ to visually 
design your user interface and 
automatically generate complete THINK 
Class Library source code; THINK 
Inspector which provides you with quick 
and easy navigation of your application's 
class hierarchy while it is running. Project 
Models to start new projects quickly from 
templates either provided in this package 
or created to lit your own needs; Source- 
Code Control with integration with Apples 
SourceScfver (included) provides reliable 
version control and supports team 
programming, Support lor Scripting lets 
you automate complex, mulliprojecL 
operations using AppleScript or Frontier 
scripting; Powerful Standard Libraries 
which includes 10 Streams, ANSI standard 
C library, and sample programs Full 
source code is included; Extensibility 
suppotis third-parly editors, and 
AppleScript and fvIPW tools (available 
from Apple) and allows access to THINK 
Reference; Create applications; desk 
accessories, device drivers; and any kind 
of code resource, including HyperCard 
XCMDs and XFCNs. system extensions, 
and controi panels; Migration Path to 
Power Mac Create applications that run 
on 6BK Mac,s and Power Macs (emulated). 
These applications can easily be migrated 
lo native Power Mac. by trading up to 
Symantec C++ for Power Mac. Price: $79 

Mastering the THINK 
Class Library by Richard 
Parker. Now that Symantec's long-awaited 
PowerPC native compiler is here, developers 
are taking another look at THINK. This bock 
provides a thorough examination of 
Symantec's extensive Class Library and ihe 
Visual Architect, a graphic user interlace 
development tool that allows you lo produce 
commercial-quality applications with a 
minimum of effort. A complete description of 
the structure and operation ot the TCI 
includes explanations ot all code generated 


by Ihe Visual Architect, any necessary 
custom code, and the operation ol ihis code. 
Visual Architect tutorials provide you will! a 
step-by-step approach for simplifying the 
development of complex Macintosh 
applications. 496 pages $29.95 $26.96 


A Fragment of Tour/^, 
Imagination by Joe Zobkiw 
Hem's some practical help for creating 
code resources and code fragments for 
Ihe Macintosh and Power Macintosh 
Rather than simply gathering and 
indexing chunks ul this vital code, the 
author provides thorough explanalions lo 
teach you more about how the Macintosh 
system functions as a whole. He also 
provides hard to find information about 
techniques used lo structure and build tal, 
safe (at, and accelerated code resources 
for use on both 680x0 and Power 
Macintosh. All code is reusable and is 
provided on the disc, along with 
Metrowerks Code Warrior Lite, Bnok/CD- 
HDM, 528pages $35.96 

Inside CodeWarrior 8: /w 

Includes GodeWarrior IDE User's 
Guide. This manual shows you how to use 
the CudeWarrior IDE (Integrated 
Development Environment). 
It shows you bow to create 
suit ware for 68K and 
PowerPC Mac OS, 
Win3?/x86, and Magic Cap 
ft also shows you how to 
use TooJServer from the IDE and how to 
control the IDE using AppleScript. The 
next highlight is CW Error Messages, 
which describes the errors you might 
encounter while using GodeWarrior 
compilers and tinkers. This manual 
contains descriptions, source code 
examples, and lixes to these errors, as 
well as the Debugger Manual, which was 
updated for CW7 including new inline and 
exceptions debugging, and a new 
troubleshooting section. Next up is Ihe 
MPW Toots Manual, which shows you 
how to use Metrowcrks compilers, linkers, 
and other tools under the MPW Shell 
Updated tor CW7, new chapters 
comparing Metruwerks and other MPW 
tools, and then onto C, C++, and 
Assembly, and Pascal Language 
Reference, covering the Metrowcrks 
implementation of C. C++, and 680x0 
assembly language programming, 
updated for CW7, The Pascal rels also 
include Ihe new UNSIGNED WORD and 
UNSIGNEDLONG Also included for this 
rime are Profiler and ZoncRanger Manuals 
updated tor CW8, $34.95 



Inside PowerPlant is the 

Power-Plant Manual, and contains 1 
Mfet. ... information about creating 
PowerPlant applications 
using ihe CudeWarrior IDE 
and PowerPlanl Constructor, 
and describes major 
PowerPlant classes and 
resources Also included are the 
PowerPlant Constructor Manual, including 



View, TextTraits and Custom Types 
editing, and PowerPlant Library Reference, 
covering all classes and lunclfons in 
PowerPlant, updated for CW8 $34.95 


New Low 
Price! 


BBEtiif 3*5 from Bare Bones Software is 
now belter than ever. 
In addition to being 
Accelerated lor 
Power Macintosh, this 
powerful, intuitive text editor offers 
integrated support for THINK C 7.0, 
Metrowerks GodeWarrior 6, THINK 
Reference 2.0 and MPW loolServer. 
Version 3.1 adds even more capability, 
including "soft” wrapping of text on screen 
and numerous refinements and 
improvements to the user interlace. 
BBEdit's many features include. Integrated 
PopupFuncs" technology for speedy 
navigation ol source code files (0. Cm. 
Pascal. Rez P G8K Assembler, and Fortran), 
unique Tfnd Differences' command 
(BBEdlt can find differences between 
projects and folders as welt as tiles), 
support lor Macintosh Drag and Drop lor 
editing and other common tasks, 
PowerTafk support lor reading, sending 
and composition of PowerTalk mail, 
scripting via any 0SA compatible scripting 
language including AppleScript and 
Frontier 3,0, and last search and replace 
with optional "grep" matching and multi¬ 
file searching. BBEdit's mhust feature set 
and proven performance and reliability 
make it the editor ot choice lor 
professionals and hobbyists alike. $99 


QCT by Onyx Technology, is a system 
extension that stress tests code during 
runtime for common and not-so-common 
errors. Tests include heap checks, 
purges, scrambles, handle/pointer 
validation, dispose/release checks, write 
to zero, de-reference zero as well as other 
tests like free memory invalidation and 
block bounds checking, GC is extremely 
user friendly for Ihe nontechnical tester 
yet oflers an API for programmers who 
want precise control over testing, GC is 
Also available in Japanese. $99 95 


FaceSpan " V2 is an extensible Rapid 
Application Designer (RAD) that makes 
building applications quick and easy. It 
combines an interactive, visual interface 
design environment with the object- 
oriented power of AppleScript nr any OSA 
language. Best ul all, faceSpan allows 
you to integrate the capability of 
scriptable programs into your custom 
application Your FaccSpan applications 
can include any number nt windows, 
dialogs, palettes, and menus. In them, 
you can display scrolling lists, popup 
menus, scrolling text, movies, multi- 
column tables, pictures, icons, buttons, 
and others While no scripting is needed 
for standard behaviors, every item may 
have its own script. You can evert 
program custom objects using Pascal or 
C. Try the perfect choice for MIS 
professionals, power users, consultants, 
and programmers. They ¥ FaceSpan t 


Includes a royalty-free distribution 
license, lor unlimited runtime users, of 
your FaceSpan-based applications. Also 
included is a FREE UPGRADE to the next 
version for registered users. $199 

Scripter* ibn Authoring and Development 
Environment lor AppleScript™. Scripter, the 
Scrip! Construction Set, is the foremost, 
comprehensive tool for creating and 
debugging AppleScript scripts. Scripter is a 
shortcul to Applescript's full capabilities, is 
both pnwerini and easy to use, and appeals 
equally to novices and experts, Scripter offers 
Ihe larges! collection of tools to answer Ihe 
needs of every AppleScript user, containing 
over 35 features, including: Superior 
vocabulary access point and click 
assembly at commands and abject 
specifications; command window lor 
experimentation. Shortcuts and extended 
editing capabilities - extensive drag-and- 
drop, six function find and replace, 
navigation markers, script library collection 
facility; many other timesavors tor faster 
scripting Interactive debugging - 
comprehensive variable watcher, expression 
evaluation, enhanced trace log, and real 
single step debugging! Other features 
include; integration wilh FaceSpan and 
background processing. Unlike other 
scripting toots, which are either based on lire 
original Script Editor concept, or are 
designed to took more like traditional 
programming fools the designers ot Scripter 
understood from Ihe outset that scripting is 
differed tram writing C code, Scripter will 
cliange Ihe way you work with AppleScript. 
From expert script design to user-friendly 
editing and implementation, Scripter is the 
natural companion to AppleScript for all 
levels nf proficiency. $199 

Macintosh Programmer's Tool¬ 
box Assistant CD-ROM - Instant 
electronic access lo inside Macintosh 
essentials. Now Macintosh programmers 
can get quick access to over 4,000 
Toolbox calls that are at the heart of 
Macintosh system software. The 
definitions of these data structures, 
resources, constants, and functions are 
documented in Ihe Inside Macintosh 
series and are essential information lor 
anyone developing Macintosh software. 
Macintosh Programmer's Toolbox 
Assistant Is a CD-ROM that harnesses The 
power ot one of the best search and 
viewing engines in the industry, tt allows 
programmers to access the Toolbox calls 
quickly from their development 
environment. With hypertext links 
allowing programmers to view related 
topics easily. Macintosh Programmer's 
Toolbox Assistant is Ihe u I Innate 
electronic reference tool for Macintosh 
programmers. £99.95 

Inside Macintosh' 3 ' CD-ROM by 

Apple Computer, Inc, Inside Macintosh is 
ihe essential reference for programmers, 
designers, and engineers for creating 
applications for the Macintosh family of 
computers. Inside Macintosh CD-RDM 
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collects more than 25 volumes in 
electronic form, including: QuickDraw'GX 
Library, Macintosh Human Interface 
Guidelines, PowerPC System Software,, 
Macintosh Toolbox Essentials arid More 
Macintosh Toolbox, QuickTime and 
QuickTime Components Now 
programmers will be able to access over 
16,000 pages of the information they need 
directly Imm their computers. Hypertext 
linking and extensive cross referencing 


across volumes allows programmers to 
search and explore this library in ways 
that are unique to the electronic medium 
Every Macintosh programmer will regard 
Inside Macintosh CD-ROM as their most 
important resource $99,95 

ScriptWizard 1.5 is the latest/j*. 
version of the best sotting script TBffl 
editing and debugging tool that 
combines the power ol a professional 


development environment with the ease of 
use that you expect of Macintosh™ software 
Compatible with all Apple© Open Scripting 
Architecture languages, Including 
AppleScript rw , ScriplWizard improves yoiir 
productivity by delivering testing and 
debugging facilities that are as intuitive as 
they are powerful. ScriptWizard makes fife 
easier for scripters by emphasizing features 
M speed script development. Some of the 
most significant enhancements lo scripter 


productivity include the ability lo single-step 
scripts (now allowing true statement-level 
stepping), watch variable values as scripts 
execute, jump instantly In frequently used 
places in a script and find and replace specific 
text. Full drag and drop text editing is 
supported. ScriptWizard delivers an intuitive 
development, testing and debugging 
environment for rapid script creation with 
essential tools up-front fur easy access $69 


BOOKS 


Advanced Color Imaging 

on the Mac OS By Apple Computer 

Inc $33,26 

OpenDoc Programmer's Guide 

By Apple Computer Inc. $40,46 

Plan and Manage Well Sites 

on the Mac By Wiederspan/Shotten 

$35,96 

Sex, Lies and Video Games By 

Hensler $31.46 

Tog on Software Design By 

Tognazzini $26.96 

See pages 18 & 19 for more information 






Learn C on The Macintosh 
Second Edition By Dave Mark: See 
page 100 

Tricks of The Mac Game 
Programming Gurus See page 100 

Macintosh G Programming 
Primer Volume I, Second 
Edition, Inside the Toolbox 
Using THINK C by Dave Mark and 
Cartwright Reed. This new edition ol this 
Macintosh programming bestseller is 
updated lo include recent changes in 
Macintosh technology, including System 
7, new versions of Ti 1INK C and ResEdit 
and new Macintosh machines. Readers 
will learn how to use the resources, 
Macintosh Toolbox and interface to create 
stand-alone applications. 672 pages. 
W $24.25 

Macintosh G Programming 
Primer Volume II, Mastering the 
Toolbox Using THINK C by Dave 
Mark, Volume II picks up where Volume I 
leaves off, covering more advanced topics 
such as: Color QuickDraw. THINK Class 
Library, TextEdit, and the Memory 
Manager: 528pgs $36.05 $24.25 

Macintosh 0LE2 Programmer's 
Reference: Working With 
Objects: Provides a complete' 
reference to the extensible protocol ol 


Object Unking and Embedding, version 
2.01 for Macintosh System 7. 
Understanding of C/C++ helpful, but not 
necessary, and comes with a CD. Working 
With Objects describes the visual and 
interactice interfaces that support the 
component objects, provides details of the 
OLE 2,01 for the Macintosh user Interface, 
addresses the issues of object class 
registration, shows how In implement the 
drag and drop objects Irom one 
application io another, covers the interlace 
that exposes the basic embedding 
functionality, and includes descriptions of 
API functions $4496 $40,45 

Macintosh Pascal Programming 
Primer Volume I. Inside the 
Toolbox Using THINK Pascal by 

Dave Mark and Cartwright Reed This 
tutorial shows programmers new to the 
Macintosh how to use the Toolbox, 
resources, and the Macintosh interface to 
create stand-alone applications with 
Symantec's THINK Pascal. 544 pages 
W $24,25 

Learn C++ on the Macintosh by 

Dave Mark. After a brief refresher course 
in C, Learn C++ introduces the basic 
syntax of Cn and object programming. 
Then you 1 11 loam how to write, edit, and 
compile your first C++ programs through 
a series of programming projects I ha! 
build on one another as new concepts 
are introduced. Key C++concepts such 
as derived classes, operator overloading, 
and lostream functions arc ail covered in 
Dave's easy-to-follow approach. 
Includes a special version of Symantec 
C++ lor Macintosh. Buok/Uisk, package 
wilh 3.5" BOOK Macintosh disk. 400 
pages, $33,26 

Programming Primer For The 
Macintosh" Volume 1 by John 
Whittle and Judy May. This book provides 
an Introduction to Macintosh 
programming, using C++ as fhe example 
language, and provides realistic, easy to 
follow, programming examples designed to 
work with either Symantec” C++ or 
Metrowerks" CodeWarrior Also includes 
one 3,5" disk with source code for the 
programming examples, along with 
numerous, useful, public domain utilities to 
use with each compiler. $37.05 $34.15 


Mastering the THINK Glass 
Library by Richard Parker. See page 68 

Programming in Symantec C++ 
for the Macintosh by Judy May and 
John Whittle. This book will introduce you 
to object-oriented programming, the Ch 
language, and of course Symantec C++ tor 
the Macintosh. You don't have to be a 
programmer, or even know anything about 
programming to benefil from this book, 
Programming in Symantec C++ for the 
Macintosh covers everything from the 
basics to advanced features of Symantec 
C++. If you are a Think C or Zortech C++ 
programmer who wants to team more 
about object-oriented programming nr 
what's different about Symantec C++, 
there are chapters specifically for you 
Includes helpful examples ol C++ code 
that illustrate object-oriented programs 
$26.95 

Symantec C++ Programming tor 
the Macintosh, Second Edition 

by Neil Rhodes & Julie McKeehan is the 
perfect Introduction to C++ programming 
- the most popular programming 
language for the Mac! This updated 
edition is Ihe easiest way to learn C++ in 
the Think environment, using many 
examples and hands-on coding 
experience. The official Symantec book, 
developed in cooperation wilh the Product 
Development staff. Provides valuable 
solutions, information, and advice for 
MPW programmers who are migrating to 
the Think environment. Disk includes 
source code from the book and example 
applications $ 45.00 $40.50 

Teach Yourself Mac C++ Pro¬ 
gramming in 21 Gays by Namir 
Clement Shammas is the easy-to-follow 
21 day format teaches readers how to 
program in C++ using the Symantec C++ 
compiler. II also shows readers how to 
develop GUI applications using [he latest 
version of the THINK Class Library (TCL). 
Targets Symantec C++ 7 0, one of the 
hottest programming languages and 
development environments. Discusses the 
bastes ol programming lor the Mac using 
TGL and the Visual Architect uliiily. Uses 
notes, tips, and warnings, as welt as Q&A, 
Quiz, Exercise, and Do/Don't sections to 
teach users the C++ programming 


language. $26,99 

Writing LacaHzable Software 
for the Macintosh by Daniel R. 
Carter. 469 pages, $25. D5 $24,25 

Global interface Design, 

A Guide to Designing^ 
International User 
Interfaces by Tony Fernandes, AP 
Professional, Global Interface Design 
addresses the issues involved in product 
development lor a global market with a 
"real world'' focus.. While covering major 
areas developers should address during 
the development cycle, Tony Fernandes 
provides insight into researching cultural 
differences. This book examines the 
differences found all over the world, such 
as cultural symbolism and taboos, and 
how they impact user interfaces, $34 Q5 
$32.35 

TafjgenTs Guide to Designing 
Programs: Well-Mannered 
Object-Oriented Design in C++ 

WM $17,55 Call for more 
Information. 

Software By Design: Creating 
User Friendly Software by Penny 
Bauersfeld (Series Editor- Tony Meadow). 
This excellent reference provides readers 
with a thorough how-to for designing 
software that is easy lo learn, comfortable 
lo operate and (hat inspires user 
confidence. Written from the perspective 
of Macintosh, but compatible with all 
platforms. Stresses user input from initial 
design, through prototyping, testing and 
revision. Provides tools for analyzing user 
needs and test responses Includes 
exercises for sharpening user-oriented 
design skills. W-95 $26,95 

Macintosh Programming Tech¬ 
niques by Dan Sydow (Series Editor: 
Tony Meadow). This tutorial and 
handbook provides a thorough foundation 
in the special techniques of Macintosh 
programming for experienced Macintosh 
programmers as well as those making fhe 
fransilion !rom DOS, Windows, VAX or 
UNIX. Emphasizes programming 
techniques over syntax ter better code, 
regardless of language. Guides the reader 
through Macintosh memory management, 
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BOOKS 


QuickDraw, events and more, using sample 
program in C++, Disk includes an 
interactive tutorial, plus reusable C++ code. 

mm $ 31.95 

More Mac Programming /v. 
Techniques: More Mac mffl 
Programming Techniques goes beyond the 
fundamentals of Macintosh programming 
With this hands-on guide and tutorial, 
you'll expand on the basic foundation of 
programming to develop truly powerful 
applications. Inside you will take a detailed 
look at the units of a Macintosh program - 
from the INITs to custom controls Wong 
the way, you'll learn solid techniques you 
can apply anywhere, including tricks and 
techniques. You will learn life resources 
Irom the ground up, and how 10 build 
custom menus, add custom controls, 
including buttons, and slider controls, 
MDEF, and CDF resources. The book wilt 
also tielp you to handle INI Is, making 
preference tiles, and how to print flawlessly 
from your programs. $35.95 

Macworld Ultimate 
Mac Programming by HOI 

Dave Mark. Reveals the ITEM! 
secrets of Mac programming 
and presents important, iimesaving 
techniques $35.85 

Mac Screamer, The Ultimate 
Macintosh Supercharging Kit try 

Jan Harrington covers 30 Macintosh models, 
including the Classics, LCs, PowerBooks, 
and Quadras and gives software solutions 
and hardware tips to accelerate Mac 
performance. It lets readers in on do-it 
yourself tips that can save them over 25% on 
upgrade costs mm $31.50 

Programming for System 7 by Gary 

Little and Tim Swibart, is 3 hands-on guide 
to creating applications for System 7. it 
describes the new leatures and functions of 
the operating system in detail. Topics 
covered include file operations, cooperative 
multitasking, Balloon Help, Apple events, 
and the file Manager, Numerous working 
0 code examples straw programmers how 
lo lake advantage oi each of these leatures 
and use them in developing their 
applications, 384 pages, mm $24.25 

Guide to Macintosh System 7.5 

by Don Crabb Written by an industry 
expert, this is the first thorough book on the 
new and improved Macintosh operating 
system. Readers will learn all the highlights 
ol the new System, including haw to work 
efficiently with applications, intuitive, task- 
oriented approach teaches topics the way 
users think, not the way the machine thinks. 
Covers all the new features of System 7,5. 
including PowerTalk, PC Exchange, and 
MacTGP. Written by a world-renowned Mac 
expert. PMQ $ 22.50 

A Fragment of Your Imagination 

byJocZobkiw Seepage 101 

How Tn Write Macintosh Software 

by Scott Krcasfer is a great source for 


understanding Macintosh programming 
techniques. Drawing from Iris years of 
experience working with programmers, Scott 
explains the mysteries and myths of 
Macintosh programming with wit and humor. 
The third edition, fully revised and updated, 
covers System 7 and 32-bit developments, 
and explores such topics as how and where 
things are stored in memory: what things in 
memory can be moved around and when they 
may be moved: how to debug your 
applications with MacsBug, hnw to examine 
your program's code to learn precisely what's 
going on when it runs, 443 pgs. mm 
$26.05 

Danny Goodman's Macintosh 9 
Handbook Featuring System 7 hy 

Danny Goodman with Richard Saul Wurman, 
It includes over 100 spreads break down and 
clarify Mac problems and includes insiders 
tips, mm $26.95 

Real World Apple Guide, 

For The Mac is the much 
anticipated help and navigational aid 
component of the new Apple System 7.5 
OS. The book is a practical Introduction to 
Apple Guide for programmers. It explains 
the design and lunciion oi Apple Guide,, 
how to design your own guides using Apple 
Script. Comes with a disk of sample Apple 
Guides for Apple Guide-compliant 
applications. $35.95. 

Danny Goodman's 
Apple Guide Starter Kit hot 

by Danny Goodman and ITEM! 
Jeremy Joan Hewes, Two 
highly respected experts offer a different 
approach lor creating your own Apple Guide 
databases With Dawiy‘s Guide Starter 
program you can make guides quickly and 
easily, without having to learn a scripting 
language, write coded files, or use several 
different files and programs to produce your 
database (which Is what you'd have to do 
without the program). The authors provide 
advice and tips on how to design a good 
Guide, from planning and creation through 
testing, revising, and indexing. Book/disk, 
320 pages, mm $31.46 

HyperTalk 2.2; The Book Second 
Edition hy Dan Winkler. Scott Kami ns, and 
Joanne DeVoto is the most complete, 
authoritative source on HyperTalk 2.2 
programming and troubleshooting if 
covers each language element ot HyperTalk 
2.2 (including the odd quirk or bug), 
mm $31.50 

The Complete HyperCard 9 2.2 
Handbook Fourth Edition by Danny 
Goodman is the biggest-selfing Mac book 
- newly revised and updated for version 
2.2. It shows how lo build working 
applications using the latest version of 
HyperCard and covers text, painting toots, 
extension commands (XCMDs), scripting 
in HyperTalk, andmore. $M; $31.50 

Dan Shafer Presents the Power of 
Prograph CPX is a hands-on, project- 
centered approach lo learning the most 


revolutionary object-oriented 
HOT programming language on the 
ITEM! planet. The language Kurt 
Schmucker likes best The 
language that programmers actually report 
having “tun" programming, This 550-page 
book takes you step by step through three 
interrelated projects of increasing complexity. 
Along the way you'll learn the underlying 
Prograph language, how to use the power of 
lists, and the important aspects of the CPX 
classes and object editors Includes disk with 
all code in the book, mm $44.95 

Visual Programming With/^ 
Prograph GPX by Scott B W 
Sleinman and Kevin G. Carver This is the 
first book on Prograph CPX available 
through the book trade, It covers the only 
commercially supported visual programming 
language at a lime when many programmers 
and managers, faced with continuing 
productivity probterns, are searching for 
better programming environments. Prograph 
CPX is much more than such GUI-enhanced 
traditional languages as Visual Basic: Jl 
literally allows you to draw your program 
flow using icons and create a complete 
application without writing a line of code. 
This bonk is an introduction to the language 
and a guide for advanced users, lor both 
Macintosh and Windows-based machines. 
Prograph is a fully pictorial , general-purpose, 
object-oriented language that speeds 
development with an integrated environment 
for design, coding, testing and debugging; 
with its DO framework for sophisticated GUI 
development: with its support tor calls from 
C, C++, Pascal, and other routines; with its 
DAL, ORACLE, Sybase, AS/400 client/server 
DB support; and many other powerful 
features. W4 $30.60 

Graphic Gems V Edited by Alan W 
Paeth is the newest volume in The Graphic 
Gems Scries. If is intended to provide the 
graphics community with a set of practical 
toots for implementing new ideas and 
techniques, and to offer working solutions 
to real programming problems. These toots 
are written by a wide variety of graphics 
programmers from industry, academia, and 
research. The bonks in this series have 
become essential, time-saving tools for 
many programmers. It is the latest 
collection ol graphics tips in The Graphic 
Gems Scries written by the loading 
programmers in the field, ft contains about 
50 new gems displaying the most recent 
and innovative techniques in graphics 
programming. Also included is new gems 
in ellipses, splines. Bezier curves, and ray 
tracing. Includes a disk which contains 
source code from all five volumes and is 
available in both IBM arid Macintosh 
versions. CONTENTS: Algebra and 
Arithmetic. Computational Geometry. 
Modeling and Transformation. Curves and 
Surfaces. Ray Tracing and Radiosity. 
Halftoning and Image Processing, Utilities. 
mm $44.95 

Applied Mac Scripting 

Applied Mac Scripting covers 


AppleScript™, Frontier, QuicKeys, Tempo 
II, nShflll, FaceSpan Application Builder, 
Scripting PlainTalk and System 7.5. With 
this hands on tutorial Tom Trinko shows 
you how to automate your Macintosh 
activities by learning how to use the 
AppleScript and Frontier scripting 
environments. You will learn the overall 
approach to designing and developing 
powerful scripts, and to harness the 
capabilities of a wide variety of Macintosh 
applications into the Integrated 
productivity tools. This includes such 
things as the newspaper script which 
combines the power uf SITcmnm. 
MacWrite Pro, and Fiiemaker Pro, or 
QuarkXPress. Whether you are a power 
user or experienced Mac Programmer you 
will learn valuable new techniques tor 
Mac automation. $34# $31,45 

Danny Goodman’s 
AppleScript Handbook hot 

Second Edition by Danny ITEM! 
Goodman is a self-contained 
kit shows the reader how to customize and 
extend the capabilities of any Macintosh 
computer - no programming experience 
needed! This enhanced and expanded 
edition nt The Complete AppleScript 
Handbook tootses on putting AppleScript 
to work in all sorts ol practical situations. In 
addition, Danny shows you how to apply 
the same principles to other popular 
scripting systems, such as UserLand 
Frontier and QuicKeys. Shows readers hnw 
to use scripts lo enhance the Macintosh 
environment, automate many processes, 
link data between applications, and much 
more. This book provides a wealth of all- 
new examples showing how to integrate 
AppleScript with the Finder, spreadsheets, 
desktop publishing programs, graphics 
applications, databases, 

telecommunications programs, utilities, and 
HyperCard. The accompanying 3 1/2" disk 
is jam-packed with over $100 worth of 
software, including AppleScript 1,1, 
valuable utilities, and powerful, ready-to- 
use scripts, mm $35.00 

The Complete AppleScript' 

Handbook hy Danny Goodman is a self- 
contained kit to customizing and 
Hot enhancing Die Macintosh 
ITEM! environment. The disk contains 
' AppleScript 1.3 Runtime, Chang 
Labs TablcScrver, and useful, ready to-run 
scripts. It atso shows the Mac user hnw to 
automate many processes - no programming 
experience necessary mm $31 .SO 

The Tao of AppleScript: BMUG’s 
Guide to Macintosh Scripting, 
Second Edition by Derrick Schneider A 
Hans Hansen. This updated bestseller is a 
complete, natural introduction to AppleScript 
programming essentials. Readers learn how 
to customize applications, automate tedious 
tasks, and create programs without having to 
use a complex programming language, 2 
disks contain AppleScript, QuickTime, Stuffll 
Lite, ResMover, and other helpful utilities 
Progressive structure meets the needs of any 
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Mac user, regardless of experience. 
Professional Instructions are mixed with 
practical examples for easy teaming mm 

$20.95 

Wireless For The Newton 
Software Development for 
Mobile Communications by Julie 
McKeehan and Neil Rhodes is 
mn a book that picks up where 
ITEM! Programming for the Newton 
left off. teaching the reader 
how to develop Newton - suElware on Die 
Macintosh. The enclosed floppy disk 
provides a sample application, as well as 
a fully funclional demonstration version 
of Newton Toolkit" (NTtC), Apple 
Computer's complete development 
environment tor the Newton*. Gives 
hands-on Newton environment training 
wilh sample code created specifically for 
the Newton* The aulhors are external 
faculty at Apple Developer University 
reaching classes on programming lor the 
Newton 1 Programming experience is 
assumed, although nol in any particular 
language, Enclosed is a floppy disk which 
contains source code for a Newton 
application, as well as demonstration 
NIK* mm $31*45 

Basic For The Newton /w 

Programming lor the Newlonlp^ 
Using NS Basic by John Schetlino &Liz 
O'Hara This book shows owners of 
Newton devices how lo become Newton 
programmers rising BASIC Ihe authors 
use a straight-forward programming by 
example" approach, which should have 
you writing your own Newton programs 
right away It includes one 3 5" disk 
containing Demonstration NS BASIC and 
over lilty example programs from the 
book II is Multi-platform in that teaches 
programming for the Newton using a 
Macintosh, a Windows-based PC r or on 
the Newton device itself, mm $32.35 

Programming for the Newton 
Software Development with 
NewtonScript by Julio McKcehan and 
Nod Rhodes, foreword by Walter R. 
Smith, Programming fnr (he Newton: 
Software Development with NewlonScripl 
is an indispensable loot lor Newton 
programmers, Readers will learn how to 
develop sotlware for ihc Newton on the 
Macintosh horn people that developed ihe 
course on programming I he Newton tor 
Apple Computer. The enclosed 3.5' disk 
contains a sample Newton application 
from the books, as well as demonstration 
version ol Newton Toolkit (NIK). Apple 
Computers complete development 
environment lor the Newtons A 
Publication of AP Professional May 1994. 
Paperback, 393 pp mm $26.95 

Metrowerks CodeWarrior Pro¬ 
gramming by Dan Parks Sydow. 
Indudes CodeWarrior Lite. 
Hqj and Full Coverage of 
ITEM! PowerPlant fM The best 
information on Metrowerks 


CodeWauior 6 . giving lull coverage 10 the 
Gold Edition Even if you don E already 
own CcdeWamor 6 . you’ll still be able lo 
work with the examples in mis hook, 
using Ihe CodeWarrior 6 Lite CO Ibat 
comes wfolimm $35,95 

C++ Programming With 
CodeWarrior Beginning HOT 
OOP for the Macintosh and ITEM! 
Power Macintosh by Jan L. 

Harrington Irani AP Professional This 
book shows programming novices object- 
oriented programming techniques for the 
Macintosh, Power Macintosh, and Mac OS 
compatibles, using C++ as Ihe example 
language and Metrowerks and 
CodeWarrior as Itte example compiler. Tire 
enclosed CD-ROM contains example code 
from the book and a full-function 
Metrowerks CodeWarrior compiler for 
running these examples. $ 35.Q5 $32,35 

Optimizing PowerPC Code: 
Programming the PowerPC in 
Assembly Language To take luii 
advantage of the potential of 
H 0 T the PowerPC, Developers 
ITEM! heed 1° master Hie Assembly 
Language techniques This 
book shows how lo use ihe Assembly 
Language in PowerPC Programs to 
produce faster more robust software, 
mm $35.96 

Inside CodeWarrior 7: See page 101 

Inside PowerPlant: See page 101 

Power Macintosh Programming 
Starter Kit hy torn Ihnmpson. this is 
the first lutofial/rettf ence for programmers 
who want to enter the new world ol the 
PowerPC chips Users find all the details 
on ihe new microprocessors. Ihe new 
RISC architecture, and how to write natrve 
code and emulation operations to create 
their own software tor Ihe Macintosh 
PowerPC CD-ROM includes a unique 
compiler for writing code easily The all 
in -one book that gets programmers the 
information and lools they need. 
Programming examples reinforce 
explanations ol code and programming 
tools mm $35*10 

The ResEdit All Night Diner hy 

David Ciskowski. An idea-tilled menu and 
introduction lo Ihe joys of customizing 
software - and adding personaliiy lo the 
Mac with ResEdit! Shows readers how to 
customize dclaull icons, the text nf menus 
and dialog boxes, cursors* pn inters, and 
more. Provides specific recipes lor doing 
erealive things with ResEdit - plus how to 
avoid problems Disk features ResEdit 
program, plus lots ot sample resources 
mm $22.45 

ResEdit" Complete, Second 
Edition by Peter Alley and Carolyn 
Strange Wilh ResEdit, Macintosh 
programmers can customize every aspect 
ot their interface form creating screen 


backgrounds and icons to customizing 
menus and dialog boxes 608 pages 
Rook/disk package $34ffe $31,45 

Sad Macs, Bombs, Disasters 
and What to Do About Them by 

Ted Landau comes to the rescue with your 
Macintosh problems. From fractious fonts 
to the ominous Sad Macintosh icon, this 
emergency handbook covers the whole 
range of Macintosh problems: symptoms, 
causes, and what you can do to solve 
them. 640 Pages mm $22*45 

Macintosh" Crash Course by 

Glenn Brown shows Macintosh power 
users whal lo do when things go wrong 
wilh their system. Macintosh Crash 
Course shows readers how to overcome 
Macintosh system crashes, system lock' 
ups. and various* frustrating and cryptic 
error messages they regularly encounter. 
II includes a CD-ROM with shareware and 
freeware to help the user diagnose and 
repair system failures Includes up-lo date 
coverage through Macintosh System 7.5, 
Managing memory. Hardware diagnostics* 
File recovery* PuwerBook problems. 
PowerPC problems, network utilities, Itard 
drive repair utilities, SCSI problems, conflicts 
and solutions and File synchronization and 
utilities, mm $26.95 

Multimedia Authoring: Building 
and Developing Documents try 

Scott Fisher addresses the concerns that 
face anyone trying to create multimedia 
documents It offers specilic advice on 
when to use different kinds ol information 
architecture, discusses Hie human-lectors 
concepts thal determine how readers use 
and retain information* and them applies 
these findings to multimedia documents, 
covering the high-level issues concerning 
planners and authors ol multimedia 
documents as welt as those involved in 
evaluating or purchasing multimedia 
platforms Includes one 3.5" high-density 

mm $ 31.45 

Multimedia Starter Kit for 
Macintosh by Michael D Murie. This 
hands-on book offers the latest and 
greatest in multimedia for the Mac! 
Readers learn how to design fheir own 
multimedia projects step by step, then try it 
themselves with the demos, graphics, 
dips, and sample projects on the CD- 
ROM! CD-ROM contains QuickTime, 
sound and graphics clips and utilities, 
sample projects, and more. How to choose 
and use a variety ot Macintosh multimedia 
lools and presentation environments 
Includes demos of Adobe Illustrator, 
Premiere. Heizer Software programs, and 
more W9 $27.00 

QuickTime Starter Kit for 
Macintosh by Robert A Letlien & 
Judith Stem, This is the ultimate package 
tor getting productive and having fun with 
Macintosh movie making Easy steps and 
valuable sotlware help readers play, 
make, and edit QuickTime movies. CD- 


ROM includes QuickTime tools, movie 
dips, shareware, and demos ot Premiere 
and oilier programs. Written by members 
of the respected Berkeley Macintosh User 
Group Tips on the best ways to bring 
live-action video to Mac multimedia 
mm $40.50 

3-D Starter Kit for Macintosh by 

Sean Wagstaff, The complete reference to 
3-D graphics on the Macintosh ideal for 
beginning lo intermediate product 
designers, illustrators, graphic designers, 
multimedia developers, animators, and 
video producers, as well as architects and 
engineers! Covers more than 50 major 
Macintosh 3-D Imaging software 
packages the mosl comprehensive bonk 
available Lois of idea-packed examples 
thal illustrate how 3-D products work - 
individually and together CD-ROM 
includes sample models, image galleries, 
backgrounds, and textures, plus 3 D 
software tryout versions $40.00 $36.00 

The Instant Internet Guide by 

Brenl Hestup and David Angel!, An Internet 
jump-start - how to access, use and 
navigate global networks The Instani 
Internet Guide equips readers with the 
tools needed lo have! ttie eleclrunic world. 
Din bonk highlights the most important 
sources of Internet news and information 
and explains how to access information on 
remote systems St outlines how to use 
essential Internet utilities and programs 
and Includes a primer on UNfX lor the 
Internet. 224 pages mm $13.45 

Internet Power Tools by John Ross 
is designed for intermediate PC users, 
Internet Power Tools is a complete 
hook/disk package that allows access lo 
ttie world's largest network - Ihe Internet - 
with Die same ease as one uses Windows, 
The detailed instructions allow readers to 
find their way around the Internet fast and 
covers e-mail, file transfers, remote logon, 
on-line directories, and more The 
accompanying disk is packed with powerful 
utilities, including Cello, PC Ludora, and 
Panda - easy-to use graphical user 
interlaces (GUI) that obviate Ihc need lor the 
obscure Unix line commands that everyone 
else must learn. It also provides access to 
even more software via Random House’s 
Internet FTP site and shows how to conned 
to the Internet via a network connection or 
dial in mm S 36 .oo 


Web Bead; The Mac 
Guide to the World Wide^ 

Web Dy Mary Jane Mara Published by 
PcachPir Press This is a beginning to 
intermediate book fftai snows you how to 
gel the most Irorn Ihe Web. using plain 
talk ttial beginners will understand, and 
online veterans will appreciate. Web Head 
also includes in depth tours ot the three 
leading Web browsers fnr the Macintosh: 
Netscape, MacWeb, and MacMosaic. and 
explains Ihe basics behind all Web 
browsers - so you will be ready even 
when Ihe next ho! Web browser hits the 
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scene II will also led you how to (]et 
connected to the Web. I Ending your way 
across webspace. line-tuning your Mac 
tor lop Web performance, and how 1o turn 
your Mac into a multimedia Web browser 
There Is also instruction on how to build 
your own home page, posting pages on 
the Web, and avoiding common HIML 
mistakes, mm $22,45 

The Underground Guide 
Telecommuting by Woody 
Leonhard, Addison Wesley There's no 
place like home, bspecially when your 
boss, your kid, arid Ihe neighbor's dog are 
all barking tor your attention 
simultaneously Working away from a 
corporate oflicc presents great (often 
unexpected) challenges end otters even 
greater rewards. Woody Leonhard takes on 
the tnughesl aspects of telecommuting and 
gives you the straight scoop on how to 
make it work for you. Whether you're a 
telecommuter, a telecommuter's boss, or 
just curious, The Underground Guide It) 
Telecommuting will give you the loots and 
information you need to turn electricity and 
a phone line into major productivity 
$22-45 


The Elements ol E-Mail Style by 

Brent Hestop and David Angctl Loam the 
rules of the road in (he e-mail age. 
Concise, easy-to-use formal explaining 
essential e-mail guidelines and rules It 
covers style, tone, typography, formatting, 
politics and etiquette It also outlines baste 
rules of composition within the special 
context of writing c mail and Includes 
samples and templates lor writing specific 
types nt e-mail correspondence 20B 
pages, mm $13,45 

E-Mail Essentials by Fd Titter & 
Margaret Robbins is a hands on guide to 
the basics of e-mail, the ubiquitous 
networks communication system The 
book is suitable lor both the casual e- 
mailer and the networking professional, as 
it covers everything from the installation 
Ot e-maif to the maintenance and 
management ol e-mail hubs and message 
servers, the books explains Ihe 
fundamental concepts and technologies 
ol electronic mail, featuring chapters on 
Lotus applications and CompuServe, as 
well as information nn upgrading, 
automation, message-based applications, 
and user training, E-mail Essentials is a 


step-by-step, jargon-free guide that will 
enable the e-mail user to get the most oul 
of ihe communication potentials of 
networking 250 pp mm $22.45 

The Computer Privacy 
HOT Handbook is a practical 
ITEM! guide to e-mail encryption, 

data protection, and PGP 
privacy software With millions ol c 
mail messages and on-line discussions 
exchanged dally on the Internet, 
electronic security has become a key 
concern, I he Computer Privacy 
Handbook explains practical steps 
individuals can take to safeguard their 
electronic security It also gives a vivid 
description of how the ‘‘Surveillance 
Age" threatens each person's personal 
security. a nun-technical introduction 
into data encryption, and the U S 
Government's Clipper Chip surveillance 
proposal II also provides an overview 
ot PGP, (Pretty Good Privacy), ihe 
world siandard lor e-mail privacy 
mM $22.45 

PowerPC System /w 
Architecture by MindShare 


This hook describes Ihe hardware 
architecture ot PowerPC systems, 
providing a clear, concise explanation of 
Ihe PowerPC specilicaliun, llie template 
upon which all PowerPC processors are 
designed. The author provides a complete 
description ot the specification tor both 
the 32- and 6-1 bit implementations, 656 
pages OT $31.46 

PCi System Architecture, /w 
Third Edition by MmdShan: ^£3/ 
Describing revision 2.1 o! the Peripheral 
Component Inter conned (PCI) bus 
specification, fhis bonk explores PCI's 
relal ions hip to the rest ol Ihe system. It 
includes an in-depth treatment of PCI to 
PCi bridges, the PCI BIOS, the 66MH? 
PCI bus. and morn. 592 pages mm 
$31.46 

Cyberpunk Handbook, /w 
The Heal CyberpunkW 
Fakebook by St Jude. RU,Sirius, and 
Bart Nagel Published by Random House. 
This book re Ns how lo lei I ft you or 
someone you know is a Cyberpunk. 
Wm $ 8.95 
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Learn C on Late Night /w 
With MacHack covers thf-lij^ 
MacHack eminences from their inception 
in 1986. up to 1993 Doug Houseman is 
the program Chairperson ot MacHack, and 
the author of this book The 
accompanying CD contains over 1UU ol 
the best I lacks written at MacHack over the 
years, including The Grouch, NetBunny, 
Jurassicon Park. DropSave. QuickTime 
Balloon i telp, the Mac Clapper, Wavy, and 
more mm $26.95 

Advanced Color imaging 

On the Mac OS explains how 
you can augment the color support 
supplied with Quick draw, and 
QuickdrawGX. using the Palette manager 
to provide the best set ol colors on 
displays with limited color capabilities, 
soliciting the color choices from users wilh 
the color Picker Manager/ Using the 
ColorSync manager to match colors 
between screens and uipui and output 
devices such as scanners and printers/ 
teaming how the color Manager assists 
Color QuickDraw in mapping an 
applications color requests to the actual 
colors available. M $33*25 

30 Graphics Program-/^ 
tning Using QuickDraw 3D 

by Apple Computer, Inc Now you can 
incorporate spectacular 3D graphics into 
your applications. This book/CD-ROM 
package explores QuickDraw 3D, a 
graphics extension to the Mac OS for 
Power Macintoshes The CD contains Ihe 
complete QuickDraw 3D syslem ilsdl and 


a complete database ol the QuickDraw 3D 
API, allowing you inslant access to the 
hundreds of graphics calls via a fast 
viewing engine. BdoN/CD-RQM, 64U 
pages mm $35.96 
Tricks of The Mac Game Pro¬ 
gramming Gurus: See page 66 

Apple Guide Complete by /*. 

Apple Computer, Inc. For those 
who want the full powei of Apple's 
complete toolset, this book and CD-ROM 
package from Apple provides everything 
you need to produce guide tiles 
successfully* including Guide Maker, the 
software you use to build and lesl guide 
files. You'll learn about the complete 
cycle of designing as well as advanced 
topics such as scripting and coding guide 
files Book/CD ROM, 544 pages « 
$35.96 

Inside AppleTalk by Gurebaran S 
Sidhu, Richard F Andrews and Alan B. 
Qppenhcimcr Apple Computer, Inc. 650 
pages, mm $31.45 

AppleScript Finder 
Guide, English Dialect, by HOT 
Apple Computer. Inc. The ITEM! 
AppleScript Finder Guide is 
an essential reference lor anyone who 
wants to use AppleScript on a Mac to 
modify existing Finder scripts or to write 
new ones The Finder scripting software 
allows you to write, record, or run scripts 
that Trigger the same desktop adions that 
you trigger using the keyboard and 
mouse- actions such as opening and 


closing folders or manipulating tiles. This 
book iniroduces Finder scripting and 
describes how lo record and modify 
simple scripts. In particular, it provides 
definitions for Finder object classes and 
commands Use of this book requires Ihai 
AppleScript be installed, and you should 
be familiar wilh AppleScript Scripting 
Additions Guide, and AppleScript 
Language Guide, mm $17,95 

AppleScript Language 

HOT Guide, by Apple Computer 
ITEM! Inc The AppleScript Lang 

uage Guide is the definitive 
description of the Fnglish dialect nt Ihe 
AppleScript scripting language. This 
book is an essential reference for anyone 
using AppleScript to modify existing 
scripts or lo write new ones It also 
contains useful Intormatinn lor 
programmers whn are working on 
scrlpiabie applications or complex 
scripts. I his book begins with an 
in I reduction to scri pting and an overview 
of AppleScript's main features Most of 
the book consists ot detailed definitions 
Of AppleScript terminology and synlax m 
the I nil owing categories: Value classes, 
commands, objects and references to 
objects, expressions, control statements, 
handlers, and script objects In addition 
to definitions fhc book provides many 
sample scripts and discusses advanced 
topics such as writing command handlers 
tor script applications, the scope of script 
variables and properties declared at 
different levels in a script, and inheritance 
and delegation among script objects. la 


get ihe most out of this book, you only 
need to be familiar with Macintosh 
computers. AJthough not required some 
previous experience with another 
scripting language (such as HyperTalk) is 
also helpful mm $26.95 

AppleScript Scripting 
Additions Guide, by hot 

Apple Computer. Inc ITEM! 
AppleScript Scripting 
Additions Guide is Ihe definitive 
description ot the scripting additions that 
accompany the Fnglish dialect ol the 
AppleScript scripting language Scripting 
additions are files lhal extend 
AppleScript's capabilities by providing 
the additional commands nr coercions for 
use in scripts This honk is an essential 
reference tor anyone using AppleScript to 
modify existing scripts or write new ones, 
tl also contains information for 
programmers who want to write scripting 
additions. The Scripting Additions Guide 
is also a how to install any scripting 
additions and invoke their commands, to 
use the standard scripting additions 
commands, or to write scripting 
additions, mm $17.05. 

HyperCard Stack Design Guide¬ 
lines by Apple Computer, Inc is an 
essential book lor everyone who creates 
Apple HyperCard stacks, from beginners 
to commercial developers It covers lire 
basic principles ot design that, when 
incorporated, make HyperCard stacks 
effective and usable Topics include 
guidelines, navigation, graphic design 
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and screen illustration, tent in slacks, 
music and sound, a sample stack 
development scenario, collaborative 
development, and the Stack Design 
Checklist 240 pages mm $19.95 

Macintosh Programmer's Tool¬ 
box Assistant CD-ROM: See page 101 

Inside Macintosh”: CD-ROM: See 

page 102 

Inside Macintosh 1 ': Overview uy 

Apple Computer, Inc, Is the first book that 
people who are unfamiliar with Macintosh 
programming should read. It gives an 
overview of Macintosh programming 
fundamentals and a road map to the New 
Inside Macintosh library, Inside 
Macintosh; Overview also covers various 
programming tools and languages, 
compatibility guidelines and an overview 
of considerations for worldwide 
development, 176 pages $20.65 

Inside Macintosh”: Files by Apple 
Computer, Inc. describes the parte of the 
Operating system Ibai allow you to manage 
files. It shows how youi application can 
handle the commands typically found In a 
File menu, it also provides a reference to 
the File and Alias Managers, the Disk 
Initialization and Standard File Packages, 
510 pgs. mm $ 26.95 

Inside Macintosh*: Operating 
System Utilities by Apple Computer, 
Inc. describes parts ol the Macintosh 
Operating System that allow you to manage 
various low-level aspects of the operating 
system Everyone who programs the 
Macintosh should read this book! It will 
show you in detail how to get information 
about the operating system, manage 
operating system queries, handle dates and 
times, control the settings ol the parameter 
RAM, manipulate the trap dispatch table, 
and receive and respond to low-level 
system errors W $23.45 

Inside Macintosh : Processes 

by Apple Computer, Inc, describes Ihe 
parts of the Macintosh operating syslem 
that allow you to control the execution of 
processes and Interrupt tasks. It shows in 
detail how you can use the Process 
Manager to gel information about 
processes loaded in memory, II is also a 
reference for the Vertical Retrace. Time, 
Notification, Deferred Task, and Shutdown 
Managers 206 pages mm $20.65 

Inside Macintosh : Memory by 

Apple Computer, Inc describes Ihe parts of 
the Macintosh operating system that allow 
you 1o manage memory It provides detailed 
strategies lor allocating and releasing 
memory, avoiding low memory situations, 
reference to Ihe Memory Manager, Ihe 
Virtual Memory Manager, and rriemory- 
relatod utilities. 296 pages $ 22.45 

Inside Macintosh*: AOCE 
Application Interfaces by Apple 


Mar Order Store 


Computer, Inc, shows how your application 
can lake advantage ol the syslem software 
features provided by PowerTalk system 
software and Ihe PowerStwe collaboration 
servers Nearly every Macintosh application 
program can benelil from the addition of 
some of these features, This book shows 
how you ran add electronic mail capabilities 
to your application, write a messaging 
application or agent, store information in 
and retrieve information from PowerShare 
and other AOCE catalogs, add catalog 
browsing and ffnd-m-catalog capabilities to 
your application, write templates that extend 
the Finder's ability to display information in 
PoworSham and other AOCE catalogs, add 
digital signatures to fifes or to any portion of 
a document, and establish an authenticated 
messaging connection. S4Mi $36.40 

inside Macintosh 1 ': AOCE 
Service Access Modules by Apple 

Computer. Inc. describes how to write a 
software module lhat gives users and 
PowerTalk-enabled applications access lo 
a new or existing mall and messaging 
service or catalog service. This book 
shows how to write a catalog service 
access module (CSAM), a messaging 
service access module (MSAM), and 
AOCE templales that allow a user to set up 
a CSAM or MSAM and add addresses to 
mail and messages mm $24.25 

Inside Macintosh*: Devices by 

Apple Computer, Inc. describes tmw to 
write software that interacts with built-in 
and peripheral hardware devices. Wilh 
this book, you'll learn how to write and 
Install your own device drivers, desk 
accessories* and Chooser extensions: 
communicate with device drivers using 
the Device Manager: access expansion 
cards using the Slot Manager; control 
SCSI devices using SCSI Manager 4,3 or 
Ihe original SCSI Manager communicate 
directly with Apple Desktop Bus devices, 
interact with the Power Manager in 
battery-powered Macintosh computers; 
and communicate with serial devices 
using the Serial Driver mm $26.95 

Inside Macintosh : Macintosh 
Toolbox Essentials by Apple 

Computet, Inc. covers Ihe heart nl the 
Macintosh The toolbox enables 
programmers to create applications 
consistent with the Macintosh "took and 
feel". This booh describes Toolbox 
routines and shows how to implement 
essential user interface elemerris, such as 
menus, windows, scroll bars, icons and 
dialog boxes 880 pages $31.45 

Inside Macintosh**: Mere Mao* 
intosh Toolbox by Apple Computer 
Inc. covers other Macintosh (natures such 
as how to support copy and paste, 
provide Balloon Help, play and record 
sound and create control panels are 
covered in this volume The managers 
discussed include Help, List, Resource. 
Soap and Sound. mm $31.45 


Inside Macintosh*: Networking 

by Apple Computer, Inc. describes how lo 
write software that uses AppleTalk 
networking protocols, II describes the 
components and organization of 
AppleTalk and how to select an AppleTalk 
protocol It provides the complete 
application interlaces to all AppleTalk 
protocols, including ATP (AppleTalk 
Transaction Protocol), DDP (Datagram 
Delivery Protocol), and ADSP (AppleTalk 
Data Stream Protocol), among others. 
mm $26.95 

Inside Macintosh": Interap¬ 
plication Communication by Apple 
Computer, Inc. shows how applications 
can work together How your application 
can share data, request Information or 
services, allow the user to automate tasks, 
communicate with remote databases 
S344& $31.45 

Inside Macintosh 0 : PowerPC 
Numerics hy Apple Computer, Inc. 
describes the floating-point numerics 
environment provided with the first release 
ol PowerPC processor-based Macintosh 
computers The numerics environment 
conforms to the IEEE standard 754 for 
binary floating-point arithmetic. This book 
provides a description of lhat standard 
and shows how RISC Numerics compiles 
with if. This hook also shows 
programmers how to create Ifoatlng-poinl 
values and how to perform operations on 
floating-point values in high-level 
languages such as C and in PowerPC 
assembly language S384& $26,00 

Inside Macintosh”: PowerPC 
System Software by Apple 

Computer, Inc describes the new process 
execution environment and system 
soltware services provided with the first 
version Ol Ihe system software for 
Macintosh on PowerPC computers, it 
contains information you need lo know to 
write applications and other software that 
can run on the PowerPC PowerPC 
System Software shows In detail how to 
make your software compatible with the 
new run-time environment provided on 
PowerPC-based Macintosh computers, It 
also provides a complete technical 
reference tor the Mixed Mode Manager, 
Ihe Code Fragment Manager, and the 
Exception Manager. mm $22.45 

Inside Macintosh": Sound by 

Apple Computer, Inc. describes the parts 
of the Macintosh system software that 
allow you to manage sounds, if contains 
information that you need to know to write 
applications and other software that can 
record and play back sounds, compress 
and expand audio data, convert text lo 
speech, and perform other similar 
operations. $24.25 

Inside Macintosh : Text by Apple 
Computer, Inc. describes how to perlonn 
text handling, from simple character 
display to multi language processing. The 


Font, Script. Text Services, and Dictionary 
Managers are all covered, in addition to 
QuickDraw Texl, TexlEdil. and international 
and Keyboard Resources mm $35.95 

inside Macintosh*: Imaging by 

Apple Computer, Inc. covers QuickDraw 
and Color QuickDraw, The book includes 
general discussions of drawing and 
working with color. It describes the 
structures that hold images and image 
information, and Ihe routines that 
manipulate them. It also covers the 
Palette, Color, and Printing Managers, 
and the Color Picker, Color Matching, 
and Picture Utilities mm $24,25 

Inside Macintosh”: QuickDraw" 
GX Graphics by Apple Computer, Inc. 
shows readers how to create and 
manipulate the lundamental geometric 
shapes of QuickDraw GX to generate a 
vast range of graphic entities, ft also 
demonstrates how to work with bitmaps 
and pictures, and specialized QuickDraw 
GX graphic shapes SM $24.25 

Inside Macintosh*: QuickDraw" 
GX Objects by Apple Computer, Inc. 
introduces QuickDraw GX and its object 
Structure, and shows programmers how 
to manipulate objects in all types of 
programs. $24,25 

Inside Macintosh*: QuickDraw" 
GX Environment and Utilities 

A companion to QuickDraw" GX Objects, 
this book contains programming 
information useful to any developer 
writing QuickDraw GX applications. If 
describes QuickDraw GX memory 
management, error handling, debugging, 
and mathematical functions, as well as 
conversion from QuickDraw to QuickDraw 
GX mm $26,95 

Inside Macintosh*: QuickDraw 1 " 
GX Library by Apple Computer, Inc is 
(he powerful new graphics architeclure tor 
the Macintosh Far more than just a 
revision ol QuickDraw, QuickDraw GX is a 
unified approach io graphics and 
typography lha! gives programmers 
unprecedented Itexihility and power in 
drawing and printing all kinds of shapes, 
Images, and text. 

Inside Macintosh*: QuickDraw" 
GX Printing This book Is essential for 
any developer whose QuickDraw" GX 
application supports printing. II shows 
how lo support the new printing features 
of QuickDraw GX, including desktop 
printers and expandable printing dialog 
boxes. QuickDraw GX Printing also 
stiows how I o use printing-related objects 
to add custom panels to printing dialog 
boxes and lo create custom page formats 
mm $24.25 

Inside Macintosh : QuickDraw 
GX Printing Extensions and 
Drivers - Any developer who wants to 
create extensions io the application 
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printing capabilities of QuickDraw"' EX, or 
who needs to write a printing device 
driver that works with QuickDraw GX 
needs this book. QuickDraw GX Printing 
Extensions and Drivers describes how to 
create printing extensions and printer 
drivers, and provides a complete 
reference to the messages, functions, and 
resouroestfiat they use, W $26.95 

Inside Macintosh-: QuickDraw 
GX Programmer’s Overview - Idas 
book provides an introduction to 
QuickDraw" GX, providing an overview ol 
the QuickDraw GX environment trom a 
developer's perspective, it introduces the 
QuickDraw™ GX programming and runtime 
environments, the relationship between 
QuickDraw GX and the rest of the 
Macintosh'" systems software and the 
relationship between QuickDraw GX and 
Macintosh applications. The key elements of 
QuickDraw GX programming, data 


structures, object types, and functions used 
most frequently by QuickDraw GX 
developers are also covered. After a general 
introduction, this book provides readers with 
a series of practical examples demonstrating 
how to approach programming with 
QuickDraw GX. mm $22.45 

Inside Macintosh 4 ": QuickDraw" 
GX Typography - This book is 
essential for any developer who uses 
QuickDraw" GX to manipulate text. It 
shows how to use QuickDraw GX objects 
to handle alf kinds ol text from plain, 
unstyied text to complex, mixed-direction 
and multi-language text with 
sophisticated stylistic and typographic 
variations. QuickDraw GX Typography 
shows how lo create and manipulate the 
three different types of text shapes 
supported by QuickDraw GX including 
text shapes, glyph shapes, and layout 
shapes, mm $26,95 


Inside Macintosh*: QuickTime 

by Apple Computer, Inc. is tor anyone 
who wants to create applications that use 
QuickTime, the system software that 
allows Hie integration of video, animation, 
and sounds into applications. This book 
describes all ol the QuickTime Toolbox 
utilities. In addition, it provides the 
information you need to compress and 
decompress images and image 
sequences, mm $26,95 

Inside Macintosh®': QuickTime 
Components by Apple Computer, 
Inc.covers how to use and develop 
QuickTime components such as image 
compressors, movie controllers, 
sequence grabbers, and video digitizers. 
mm $31.45 

Inside Macintosh : X-Ref by Apple 
Computer, Inc. is a fast access to all the 
information in Inside Macintosh. Inside 


Macintosh X Ref; Provides programmers 
with a quick and easy way to find the exact 
information Urey need in this definitive suite 
of books, (all 26 volumes). It is indexed by 
topic, volume, chapter, and accompanying 
page number. mm $17.95. 

Inside the Macintosh Com¬ 
munications ToolBox by Apple 
Computer. This book is the definitive 
reference to the Macintosh Commun¬ 
ications Toolbox, an Integra] part of the 
System 7 Macintosh Toolbox that enables 
developers to create communications 
applications or add communications 
features to other applications Tins book 
describes ail ot the routines that provide 
programmers with standard access to 
important commimicalions services and in 
addition enables programmers tu extend 
the reach of lire Macintosh inlo non-Apple 
environments, mm $22.45, 
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CMaster 2.0 by Jersey Scientific 
installs into 1HINK C 5 / 6/ 7 and 
Symantec C++ for Macintosh, and 
enhances the editor. Use its (unction popup 
to select a function and CMaster lakes you 
right to if. Other features include multiple 
clipboards and markers, a Function 
Piutotyper, and a GoBack Menu which can 
lake you back to previous editing contexts. 
Almost all features bindabfe to the 
keyboard, along over a hundred keyboard- 
only features like ' Add New Automatic 
Variable," Glossaries, AppleScript and 
toolServer support, Macros, and External 
Tools you create tool $129.95 

QUED/M 2 J by Nisus Software, Is a 
programmer’s text editor which has defined 
tire industry standard lor speed and 
efficiency. With integrated support for 
Symantec C/Cn, Metrowerks 
CodeWarrior 6, and MPW, GUED/M offers 
unrivaled usefulness for the Macintosh 
developer In addition Id supporting all the 
major development environments on the 
Macintosh, QUED/M oilers dozens ol 
powerlul editing features, including 
unlimited undo and redo, UNIX style GREF 
searching, macro language, scripting, text 
folding, text sorting, file comparison and 
merging, toolbox lookup, ten 
editable/appendable clipboards, line 
numbering, markers, displaying text as 
ASCII codes, vertical and horizontal screen 
splitting, plus much more. $149 

GodeManager™ Microsoft* 

Visual SourceSale™ 4.0 compatible 
source code control system for the 
Macintosh* $399. Calf for more info. 

GodeVUamor “ 8 CD by 

MeLrowerks comes in two versions 
- Bronze and Gold These CDs 


m contain the CodeWarrior 7 
■ development environment 
\ including C++, C and Pascal 
a ■ i;i Ik rs; high-speed linkers; 
hiTM-wM native-mode interactive 
debuggers; and a powerlul new application 
framework called PowerPlarrt for rapid 
Macintosh development in C++. Bronze 
generates 600x0 code. Cold generates both 
680x0 arid PowerPC code. Comes in two 
versions - Bronze and Gold. New to these 
versions is an Integrated Class Browser 
Faster code, Better Code Generation for 
PowerPC Updated QpenOoc™ support. 
New Networking Classes In PowerPlant, 
New Editor Functions. Im Overhead 
Exceptions lor Cm. Libraries for the new Be 
Operating System. CodeWarrior 8 Gold. 
With CodeWarrior’s plug in architecture, 
choose your target platform from within one 
Integrated Development Environment. Gold 
supports the following plailorms: 
PowerPC™- Mac™OS. PowerTV™, Be™0S 
for BeBox™ 68K: Mac™0S. Magic Cap™ 
x06: Windows 95™, Windows NT™. It 
includes C/C++ and Object Pascal. 
CodeWarrior 8 Bronze. Macintosh 
programming solution teal generates code 
that runs native on 68K and runs emulated 
on PowerPC. Supports C/C++ and Object 
Pascal, Gold $399, Includes a 1 year 
MacTcch subscription Bronze $149. 
Includes a 6-monlh subscription. 


SYMANTEC. 


Symantec C++ See page 101 

THINK Pascal v. 4.0 by Symantec 
Corporation. Professionals and students 
will welcome Ibis version of THINK Pascal, 
it is fully integrated for rapid turnaround 
tin re and lets you lake advantage oi System 
1 capabilities. Features include support tor 


large projects, enhanced THINK Class 
I sbrary, System 7 compatibility superior 
code generation, and smart linking, Product 
Contents: Four Macintosh disks, a 552- 
page user manual, and a 498-page object- 
oriented programming manual. $169 

LS Object Rascal CD includes the 
world’s first Object Pascal compiler tor 
Power Macintosh.. 100% compatible with 
Apple's MPW Pascal, LS Object Pascal 
combines the best of Apple’s native 
development toots with innovative new 
technology developed at language 
Systems. Compiler options specify 68K or 
native PowerPC code generation, included 
on the CD are: LS Object Pascal compiler. 
Universal Pascal Toolbox interfaces, fully 
loaded MPW 3.3.1, 68K and PowerPC 
source debuggers, PowerPC assembler, 
online documentation, Macintosh Tech 
Notes, and a special version ol AppMaker 
by Bowers Development that generates 
native Pascal source code. The beta 
release includes upgrades to vl 0 when it 
becomes available. $399 

LPA MacProlog comprises a 
Edinburgh syntax Prolog compiler system 
set in an attractive multi-window 
development environment with an 
integrated program editor, graphical call 
graph facilities and an interactive source- 
level debugger. LPA MacProlog features 
high-level access to the Macintosh 
ToolBox for using graphics, dialogs, 
windows, icons, resources in a simple and 
versatile way LPA MacProlog also includes 
interfaces to G and Pascal code resources. 
The MacProlog Ron-time Generator 
enables the production of double-clickable 
distributable applica tions The compact 
run-time system supports first argument 
indexing, tail-recursion and last-call 
optimization. Optional add-ons tools 
include flex, Prolog* h, MacDBf for Oracle 


and the MacProlog Dialog Edilor, 
Programmer Edition $745, Developer 
Edition (which includes the run-time 
generator and distribution license) $1500 

SmalltalkAgents® (STA) is a 
sophisticated 
application 
development 
environment 
featuring a new generation of tee Smalltalk 
language, QKS Smalltalk™. Productivity is 
no longer measured in lines of code, but 
in project completion time. STA allows 
"live” direct manipulation of your objects. 
The development process is dynamic, 
interactive and iterative. Just like C/C++ 
and Assembly, STA provides easy and lull 
access to the features of the MacQS™ and 
Mae Toolbox. Yon can link your non- 
Smalltaik code resources using our 
External Code Linking Toolkit™ (ECLT) 
You can also call back into STA bom 
foreign functions written in C/C++. Pascal, 
FORTRAN, and Assembly STA's 
automatic garbage collection and object- 
based typing will tree you Irani tedious 
memory management and bookkeeping 
chores A sophisticated database for 
source code management provides an 
almost infinite variety of ways to cross- 
reference, access, view, and manipulate 
your code and objecLs. STA includes an 
Application Delivery Toolkit™ (ADI) that 
altows you to create royalty-free, stand¬ 
alone, double ■clickable applications in 
just a matter of minutes. The foundation of 
the QKS Product Family, the Agents 
Objecl System (AO/S). Is an underlying 
task framework, housing components and 
services that save you years of work. Any 
component built in AU/S will function as 
an Open Doc component or container and 
components from non-AO/S sources can 
be seamlessly integrated into the AO/S 
system Smal ItalkAgents List Price: $695. 
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SOFTWARE 

E 



ICON IX Powerlools by a. 

ICONIX has been a tearfmglg^ 
supplier of CASL tools, since 1984. One 
of Ihe Ifrsl Object-Oriented CASE tool 
developers, ICONIX is known throughout 
the Industry for producing affordable, 
high-quality tools and stai& ct the-art 
(raining, Our line ol Object-Oriented 
Analysis and Design loots, ICONIX 
PowerTools, is an integrated set of ID 
CASE tools supporting the major phases 
of the system development life cycle and 
automating analysis, design, coding, and 
the management of complex systems. 
ICONIX is unique because we are the first 
to bundle CASE tools, CD-ROM training, 
and on-site training and consulting. Each 
individual module is $1,495. PowerPack 
Bundles- Choose any 6, 8 or 10 distinct 
modules of your choice to customize your 
own ICONIX PowerTools toolset. Our 
professional sales stall will gladly assist 
you in choosing the right tools for your 
project's needs PowerPack/6. $5,995 
Power Pack/8: $6,995 PownrPack/10: 
$7,995. (Full Product Line) Call lor 
pricing on Upgrade Service & Training 
and Consulting, 

Voodoo Is a version control tool for the 
voodoo s ’ rn P ,e ancl c ' e9f bianage- 
p ™ menl of projects in which 
fffes are created in 
numerous versions 
(variants and revisions). 
Voodoo allows both variant and revision 
control, and it manages not only variants 
and revisions nt single tiles, but ol a whole 
software project (multi files, multi users, 
mulli variants, access rights,.The tool 
otters a neat graphical user interface and is 
not only suitable for mere source code 
control but can handle all 
HOT dilfererit kinds ol files with 
ITEM! amazing compression rates: 
typical size of delta between 
arbitrary files 5% (in words: five per cent) 
fill no matter whether the files are plain text 
or any other documents - e.g., MSVUord, 
4D, Canvas, FileMaker ... Please note 
special prices for multiple copies: single 
license $190; 2 pack $300, 5 pack $665. 
10 pack $1140; 20 pack $2000 Add'l 
pricing available on request. 


PROFILERS/ 

DEBUGGERS 


LJ Profiler by Lars Jordebo 
Dalakunsull supports profiling of C++ 
68 K and PowerPC applications compiled 
with CodeWarrior 6, CFront or Symantec 
C++. Based on active profiling, i.e 
prating code called at function enter and 
exil the browser application lets you 


follow call drain timings in hierarchical 
views or separate windows. Collect, 
organize, compare and save profiling data 
from different versions of your application 
into a project. Scriptahle and recordable 
with full access to mosl internal data 
structures. Optional remote profiling and 
hacking ol segment and slack usage. Full 
source code to what you link into your 
application. $295. 

Last Resort Programmer's 
Edition records every keystroke, 
command key and mouse even! (in local 
coordinates) to a file on your hard disk. 
This is especially useful for program 
testing & riehugging, and tor technical 
support and help desks, tf something 
goes wrong (because of a power (allure, 
system crash, forgetting to save or 
deleting lines) and you lose a word, 
phrase, or document you can look in the 
Last Resort keystroke tile and recover 
what you typed, Last Resort ts also useful 
fur Technical support personnel, when 
they have to ask “What was the last thing 
you did before...?" $74.95 

QC" by Onyx Technology See page 69 
The Memory Mine by Adiarila is a 
stand alone debugging tool for Macintosh 
and native PowerPC. Programmers can 
monitor heaps, identify problems such as 
memory leaks, and stress test appli¬ 
cations. Active status of memory in a 
heap is sampled on Hie fly: allocation in 
non-relocatabie (Plr), relocatable (Han¬ 
dle) and tree space is shown, as are heap 
corruption, I rag mental ion, and more,.. 
Allocate, Purge, Compact, and Zap 
memory let users stress test all or part of 
a program, Source code is not needed to 
view heaps, II works on Macintoshes with 
68020 or later and System 7.0 or later 
$99 

Spyer by inCider is a simple operated 
tool that records ail actions (including 
mouse movement) you perform on a 
Macintosh computer and then 
replays them at your preferred speed 
The recorded data can be saved in lifes 
for future use. Spyer works as a 
background process will! any Macintosh 
application and is triggered by user 
defined Hoi Keys. Spyer enables the 
Tonlmuous Redo" utility and is 
especially useful for soltware testing and 
demonstration. $39 


INSTALLER TOOLS 


InstaflerPack" by SteplJp Software is 
a package of several Installer “atoms" that 
lei developers incorporate graphics, 
sounds, tile compression and custom 
foider icons into installation scripts. 
Compression lormats supported are 
Compact Pro & Diamond. Each atom also 
available separately. Compression 


requires additional licensing. $219 

ScrfptGen Pro™ by StcpUp Software 
is an Installer script generator which 
requires no programming or knowledge 
of Rez. Supports SiepUp's tnslallerPack, 
SLufllt compression, custom packages, 
splash screens, network installs, Rez code 
output, importing resources, and 
AppleEventlinkw/MPW: $169 


LIBRARIES/ 

FRAMEWORKS/ 

DATABASES 


OOFfLi See page 100 
PowerTap 1 * See page 100 

3D Game Machine vl.2 by 

Virtually Unfimifetl is a C library tor 
creating lightning-last 3D arcade games 
and interactive multimedia applications, 
3DGM has a simple easy-lo-use interlace 
and features very last rendering (15 
Irames per second on a 14" monitor 
completely texture-mapped, wilh a 
PowerMac 6100/60), lull "virtual" 30 
worlds wilh six degrees ol Ireedom, Iree- 
form texture mapping, shading, material 
and light properties, convex/cave 
polygons with unlimited vertices, 
unlimited light sources, dynamic hidden 
surface removal, special graphic modes 
lor fast lull-screen animation, collision 
detection, explosion simulation, 3D data 
importing. Runs on all Macs! Works with 
CodeWarrior. $299 +license. 

Animation Class Library version 

2.0 (ACL2.Q) is an advanced object- 
oriented multimedia framework, allowing 
fast development of high-quafity 
interactive applications. Main features of 
ACL2 0 are: Powerful animation engine 
which supports structured sprites, 
collision detection at pixel precision, 
sprites sorting, powerful blitter and vector 
objects Scrolling of background picture 
in circular buffer and tile-mapscrolling. 
Application framework lor building 
standard and 3D controls, partes.menus, 
lull screen displays, windows, etc. 
Quicktime and multi-channel sound 
support >800 functions and >1D0'00fl 
lines. Complete C++ source code fur 
CudeWamur and Symantec C++, 
examples, documentation and technical 
supporl. $250 

dtF is a true relational database system 
for Apple Macintosh computers. dtF 
provides a powerful choice for developers 
who wanl to create database centered 
applications with no performance trade¬ 
offs dtF features SGI, full transaction 
control, error recovery, single user, client 
server architecture and multi-platform 
supporl including DOS, Windows. OS/2 
and UNIX, The C/C-h API is identical and 



fully portable cross all supported 
platforms, Third-party vendors supporting 
dtF will be able rn offer a variety nt 
advanced features and benefits Id then 
customers royalty free. Tools are included 
(oi importing, exporting, creating and 
managing databases and users 
Supported development environments 
include: Symantec, MPW, Mefrowerks 
and more. Mat/SDK $695 


MacWiref rame by 

Amplified Intelligence. 
Create your own virtual 
reality application with 
MacWireFrame, a virtual reality 
application frame work. Includes a 
complete library of object oriented 
graphics routines, its own easy to 
understand application frame work 
(similar to MacApp or f CL but a lot easier 
to understand), plus an example 
application program lhat lets you start 
solid modeling right away Comes 
complete with fully documented source 
code. All new purchases will be 
guaranteed a $49.99 upgrade to the soon 
tc be released, scriptable, MacWireFrame 
5.0. Due to the overwhelming response 
the special price offer has been extended 
for a little white longer Special Offer: 
m&m $75!!! T 


j: 


PictureCDEF 

1.3 by Paradigm 
Software is a 
professional-level CDEF for creating 
custom graphical buttons (8-64 pixels). 
PictureCDEF is used in products by 
Adobe, ProVue, S1F lech- 
hot nolog res and others IE is 

ITEM! multi-monitor and bit-depth 
sensitive. The button graphic 
(cicn, RcsFdit) can be changed at runtime 
and even animated with a call-back 
routine. Create dislincl buttons in seven 
varialions: MultiStale. PushButton, 
FtexiButton, ToggleButton, ChkRutton, 
PushPictBufton and TogglePictButtnn. 
Position the optional button title at letl, 
bottom or right, or lolluw the system text 
direction for international support. 
Manual, sampfe code and MacApp 3.0 
support included. Full source code 
$95.00 Object code: $45.00. 


Q3S/3riPane/SmartParie source 
code bundle by Vivister Consulting. Q3S: 
source code bundle from ViviStar 
Consulting. Full featured 3d graphics. 
Points; tines; polygons; polyhedn; 
Gouraud shading; z-buifering: culling; 
depth cueing; parallel, perspective, and 
stereoscopic projections; performance 
enhancing "OnlyQD" and ’Wireframe" 
modes; full clipping; pipeline access; 
animation and model inte rani ion support, 
and a "triad mouse 11 to map 2d mouse 
movement to 3d 3d Pane provides 
integral ion with the TCL and provides a 
view orientation controller. Smart Pane 
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provides TCL oNscreen image bullering, 
flicker Iree animation, and QuickTime 
movie recording SmartPane functions in 
3d or 2d scenarios All work with C++ 
compilers or ThinkC 6 and compile to 
PowerPC or 68K target machines $192 

Speilswell 7 1,0,4 is an award- 
winning. comprehensive, practical spelling 
checker that works in batch mode or wilhin 
applications that incorporate the Apple 
Tvents Word Services protocol (e.y.„ 
Eudnra, WordPerfect, Communicate!, and 
Fair Witness), Speltsweil l checks ter 
spelling errors as well as common typos 
like capitalization errors, spaces before 
punctuation, double double word errors, 
abbreviation errors, mixed case errors, 
extra spaces between words, a/an belore 
vowel/corrsonanl elc... MacTecb orders 
include developer kit with Wrileswell Jr., a 
sample Apple Events Word Services wmri- 
proecssor and its source rode. $74 95 


StoneTable Extra: Additional 
functions for StoneTable Drag selected 
cells within table or to older tables: 
Optionally add rows as part of drag; popup 
menus or check boxes in cells: variable 
width grid lines: move/drag/resize table in 
window; clipboard operations on multiple 
cells Requires StoneTable (all prices per 
developer) $50 first compiler, additional 
compilers $25. 

StoneTable: A library replacing all 
functions found in list manager plus; 
variable size columns/rows; diUnreal font. 
Size, style, fnrecolor, backcolor per cell; 
sort, resize, move, copy, hide 
culuinns/rows; edit ceUs/lilles in place; 
lilies for columns/rows; multiple lines per 
cell; grid line pattem/color; greater than 
32k data per table, up to 3?k texi per cell, 
support for balloon help and binary cell 
data Versions lor Think C, Think Pascal, 
MPW C. MPW Pascal, CodeWarrror 6 C 


(all prices per developer) $150 lirsl 
compiler, additional compilers $50 

StoneTable and StoneTahle- 
Extra for PowerPC: Same function 
aiity as 6RK libraries. Versions tor MPW 
C and CodeWairfor 6 C, Must have GBK 
libraries, (ail prices per developer) 
StoneTable $10U. StonelableExlra $25 

B Tree HELPERS 2.2 is an /w 

inexpensive database engine for 
Macintosh programmers in C source 
code B-tree HELPER gets space in a file 
in contiguous fixed length blocks It 
expands She file as necessary and 
contracts files when possible B tree 
Hfl PER inserts and deletes keys in une 
or more B-frees II liutls keys equal to, 
less titan, or greater than a given value in 
a few hundredths of a second It finds 
tisls of records whose keys are equal In, 
less than, or greater than a given value or 


are In a range of values $150 

AppMaker makes II taster and 
easier lorieveinp the user interlace 
Inr a Macintosh application Just point 
and click to design your application, then 
AppMaker creates resources and generates 
excellent source code AppMaker supports 
most development environments including 
Mefrowerks. Symantec, or MW: C, C++, 
or Pascal; procedural ur object-oriented, 
using PowerPIM, TCL, oi MacApp The 
generated code uses Ihe Universal Headers 
to provide PowerMac compalihilily 
Jteflinrvers m AppMaker lo Jeam nb}ecl- 
oriented and Macintosh Toolbox 
programming techniques Experts use it to 
increase productivity It saves so much 
lime it's like having your own assistant 
programmer working lor you Includes 
one year subscription nn CD $299 


SCRIPTING/SYSTEM ADMINISTRATION 


SCRIPTING/ 

SYSTEM 

ADMINISTRATION 


ScriptWizard See page 102 

FaceSpan ’ v2: See page 901 

DataScript DataScripf is probably he 
quickest, easiest and most cnst-eltedive 
way to make your integrated AppleScript 
solutions database aware-today 
Quickes!: It takes just six lines of 
AppleScript to make new or existing 
scripted solutions database aware, and 
fetch data bom RDBM's such as Oracle, 
Sybase, DB2, or Informix Easiest: 
UalaScnpt's scripting terminology is easy 
to learn, easy to use. and easy to 
remember "Inside QataScnpt" contains 
lots of easy to follow scripts to muse in 
your own solution. Cost Effective: 
Because DataScrlpt is so easy to learn, 
and use you h ll became productive very 
quickly, and once youTe ready to ship, 
you'll find our licensing schemes very 
attraclive. $249,00 

Scripter : Seepage 101 

Climate by Orchard Software is a 
command line interface lhal lots you 
communicate with your Macintosh using 
English commands to create, delete, 
rename, and move tiles and folders. It can 
start applications, formal disks, restart 
your computer, etc, Climate supplements 
the Finder It includes a BASIC interpreter 
that lets you script your Macintosh 
without AppleScript The interpreter 
includes advanced programming 
constructs; repeal loops, lf/lhen/else 


conditionals, subroutine calls, etc 
CLlmate implements wildcard characters, 
enabling you to work on groups of files. 
Use Cl [mate instead ot MPW to manage 
your projecls Climate is an application 
occupying 7QK disk space. 31 comes 
bundled with sample programs and full 
documentation $59.95 

Cron Manager by Orchard Suit ware 
implements Ihe UNIX Cron facility. It can 
open any Macintosh file on a given date 
and time By creating an alias, renaming it 
to the date and time to open, and moving 
it into the special Cron Events Folder* 
Cron Manager will open it. Cron Manager 
is a control panel lhal creates Ihe special 
Cron Events Folder inside your System 
Folder 11 is completely transparent to Ihe 
user, It works like the Startup Items folder, 
only smarter It works with any Macintosh 
file: il you can double-click to start it. 
Gran Manager can open H. $25 95 Gron 
Manager bundled wilh CLlmate, $59.95 

Rosa n ne™ Rosannc is a col feel inn nt 
utilities which olfer the user complete 
control over raw data. Users can sort files, 
extract selected records, summarize 
frequency counls, create sample files, 
perform matching on multiple files, and 
reformat data to now specifications, alt on 
the desktop, and even on files of a million 
records or more. The Rosa one Utilities 
also support AppleScript™ - , enabling the 
user lo link several actions together to 
complete an entire process. The Rosannc 
Utilities are recordable; users may 
perform a series ot actions, and using an 
AppleScript editor such as Scripter™ see 
their aclions translated directly into 
AppleScript commands. All of the utilities 
support multi-tasking and background 
processing The Rosannc Utilities will 


assist you in picking your sped I otic ns. 
detarmining record length, creating 
output files and managing the storage of 
data Rosanne Utilities: Copy 
duplicates an input flic. Formal 
creates an altered version nf an input lile, 
containing either subsets ol Ihe fields on 
the input life, or new lietds Select - 
creates a subset of the records on an 
input file based on some selection 
criteria The Recode option allows the 
user to group data, or correct coding 
entries Sort orders an input hie by a 
particular held or set ol fields Match - 
joins together two inpul files based on 
common values occurring in 
corresponding fields or sets of fields. 
Aggregate creates an output lite with 
summary levels. $595 

ScriptBase™ The Scripting 
Database is a database for storing 
persistent objects to be made available for 
access to AppleScript, Apple's systern- 
levcl user scripting language lor 
controlling applications on Macintosh" 
computers. Once installed, the database 
becomes part of the AppleScript system, 
adding a host of commands to the basic 
AppleScript vocabulary Retrieving the 
objects is simple using AppleScript's 
natural-language syntax and stiucture 
Objects stored and retrieved in ScriptBase 


can be accessible any time from any 
script on the user's computer These 
objects can be ot any typo, including 
numbers, character strings, lists, records, 
scripts, and references lo disks, files, 
lulders, as well as abstract raw data, to 
name just a few ScriptBasc can be used 
to maintain system-wide settings, such as 
sets of preferences, paths lo frequently- 
used tiles nr lolders. Complex 
installations can be made easier by 
organizing data and scripts within the 
database's sliucture $79 

Script Debugger by Late 
Night Software ltd. is a HOT 
powerful and flexible ITEM! 
AppleScript authoring tool 
Script Debugger makes it simple for novinn 
and experienced script writers tn get the 
most from AppleScript The program's 
advanced debugging environment offers 
single-step scrip! execution with 
breakpoints The Script Debugger 
dictionary browser features a graphical 
view of objects provided by snriptabte 
applications Wilh the program, you also 
receive the Ute Night Sufiware Scripting 
Additions, a coi lection of more than 70 new 
AppleScript commands, and Scheduler, a 
utility that allows you lo launch scripts at 
predetermined limes, $129 


SOFTWARE FOR SALE? 

List your product in MacTeeh Magazine's Marl Order Store. 
For more information, call SOS/494-9797. 
in tcm et : marketing#xplain com 
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SCRIPTING/SYSTEM ADMINISTRATION 


TCP/IP Scripting 
HOT Addition - is the latest 
ITEM! werstori of an award-winning 
AppleScript scripting addition 
(first place in the 1991 "Best Hack" category 
in the Everyday AppIcScripf Programming 
Compelition) This scripting addition (or 
osax) allows you to write scripts using 


MacTCP' commands in AppleScript' 
Potential uses of this include sending e- 
mail or files through a script, chocking if 
users are logged on (via Finger), 
automating FTP, Gopher. NelNews, Telnet 
and LPR. verifying links in HTML 
documents, and quickly writing many other 
TCP/IP client-server programs Sample 


scripts are included already implementing 
many of these functions. When combined 
with FaccSpan, the potential for rapid 
implementation of Internet cl rent-server 
applications is enormous The TCP/IP 
Scripting Addition works with AppleScript 
1.0 or later and Mac!CP 2,0.4 or later, It is 
compatible with Open Transport* The 


TCP/IP Scripting Addition can be used from 
Script Editor. HyperCard 2.2, MacPERL, 
FaceSpan and other Open Scripting 
Architecture applications. See “http:// 
www mangotree conYbi^mangoAndexhtml 
M tor more details. $49 


MACTECH EXCLUSIVES/MISCELLANEOUS 


MacTech Magazine is your exclusive 
source for these specific products 
including available back issues of 
SFA 's magazine, source code disks 
and assorted cd's. Call for more info 
and pricing: 

Ad Lib 2.0 The premier MacApp 3.0 
compatible ViewEdit replacement A 
powerful user-interface editing loot to 
build views for MacApp 3.0 and 31 Ad 
Lib allows subclassing of all ol MacApp's 
view classes including adorners, 
behaviors, and drawing environments. 
String and text style resources are 
managed automatical ly Alternate display 
methods, such as a view hierarchy 
window, allow easy examination of 
complex view structures Ad Lib includes 
source code lor MacApp extensions thal 
are supported by the editor - buttons can 
be activated by keystrokes, behaviors can 
be attached to the application object, and 
general purpose behaviors car be 
configured to perform a number of useful 
functions Run mode allows the user to 
try out the views as they will work in an 
application. Templates can be created to 
add additional daia fields to view ciasses. 
Edlling palettes provide fast and easy 
editing ol common objects and attributes. 
Works with ACI’s Object Master (version 
2.0 and later) to navigate a project's user 
interface source code. $195 

Frameworks Magazine: $8/hack 
issue, subject to availability. 

Frameworks Source Code Disk: 

$10 per back Issue, subject to availability 

Five Years of Objects CD-ROM: 

Frameworks archives and source code 
from April 1991 to January 1993, plus 
selected object-oriented publicly available 
software and demos $95 

MADACON 93 CD-ROM: The 

highlights ul MADACON '93, including 
Mike Potel on Pink, Bedrock. MacApp 
OOPLs, and more Slides, articles, 
demos, audio, and QuickTime $95 

MAScript 1.2 adds support tor 
AppteScripl to your MacApp 3.0,1 and 3,1 
based applications Make your application 
scriplable and recordable by building on a 
tried and tested framework tor object 
model support MAScript dispatches 
Apple events to the appropriate objects, 
creates object specifiers, and makes 


framework objects like windows and 
documents serrptabie and recordable. 
Sample application shows you how to 
begin adding support tor scripting and 
recording. MAScript includes complete 
source code. Install MAScript by 
modifying one MacApp source file, then 
adding another to your project Future 
versions Ol MacApp will incorporate 
MAScript. so MAScript support you add 
now will work in the future. $199 


The Mjulner BETA System is a 

soltware development environment 
supporting object-oriented programming 
in the BETA programming language. 
BETA is uniquely expressive and 
orthogonal. BETA unifies just about every 
abstraction mechanism including class, 
procedure, function* coroutine, process 
and exception - into the ultimate 
abstraction mechanism: the pattern. 
BETA includes: general block structure, 
strong typing, whoie/part objects The 
compiler: binary code generation, 
automatic garbage collection, separate 
compilation, interface to C. Pascal, and 
assembler. The system: persistent 
objects, basic libraries wilh containers 
classes, platform-independent GDI 
application frameworks on Unix, Mac and 
Windows NT. melaprogramming system 
The loots available on Unix: the hyper 
structure editor supporting syntax 
directed editing, browsing, etc., and the 
source code debugger are currently being 
ported to the Macintosh system The 
Mjainer BL1A System tor Macintosh 
requires MPW (basic set) 3.2 or taler. 
Package containing compiler, basic 
libraries, persistent store. GUf Iramework, 
and comprehensive documentation 
(Other packages are also available) $295 

More Savvy includes ail Savvy features 
plus Apple Event support for all sub¬ 
classes ol TEventBandfef with extensive 
view support Apple Event support for text 
includes text attributes and sub range 
specification, Recnrdabtlrtv supports 
additional actions, and coercion includes 
additional types. Additional client and 
server Apple Events $450 


Savvy 1*1 05A support includes 
I allachahility, recordabifily, 
scfiptabilily, coercion, in 
I addition lo script execution, 
idling and i/o Apple Event support 
includes complex object specifiers, 
synchronous/asynchronous Apple Even! 


handling, and Apple Event transactions foi 
clients and servers The Core Suite of 
Apple Event objects is supported 
including the application, documents, 
windows, and files. Documentation 
includes technology overview, cookbook, 
and sample code $250 Savvy now 
supports MF*W 3.1,3,11 and continues to 
support 3.01, as welt as supporting 
Melruwerks CodeWamor This month 
only, special offer — AH Savvy versions 
include tree copy of Savvy QuickTime! 

Savvy QuickTime Requires Savvy, 
More Savvy, nr Super Savvy Includes 
QuickTime. Apple Event, and view 
template support. Movies come out ol the 
box ready to play, edit, and read lo Apple 
Events. They can be included in any view 
structure, including templates, and are 
displayed in the scrap view. Movie 
controls include volume, play rate, 
looping mode, display style, and other 
characteristics. $250 

Super Savvy includes all More Sawy 
features plus compile, edit, and record 
scripts using built in script editor View 
template editors, like Ad Lib. can attach 
scripts to view objects and modified 
scripts are saved with the document 
Script action behavior allow quick access 
for executing and editing scripts attached 
to views. Text to object specifier coercion 
plus more, $700 


MISCELLANEOUS 


jajgi m BASIC lor the Newton -s 

flSlffl BASIC lor the Newton 1 From 
NS BASIC Corporation, It is a 
f u |jy interactive implementation 
of the BASIC programming language. It 
runs entirely on the Ncwlon no host is 
required, ft includes a lull set ol functions 
and data types, hand-written input, 
windows, buttons and extensions to lake 
advantage of the Newton environment 
Applications can create files or access the 
buiit-tn soups Applications can also 
access the serial port for input and 
output. Work dirndly on the Newton, or 
through a connected Mac/PC and 
keyboard. NS BASIC includes a 240 page 
pocket sized manual. Runs on all Newton 
lx and 2,0 units. $99 

Inside CoiJeWarrior 7 £ Inside 
PowerPlant; See page 101 


Guide Composer gives anyone the 
ability to create powerful Apple Guide help 
systems for any new or existing Macintosh 
application. Great for commercial 
developers, shareware developers, in- 
house developers, and consultants, Guide 
Composer provides a WYSIWYG 
development environment: Guide content 
fs developed in Guide windows Design 
topics, phrases, and panels in the same 
format as the user will use them, Features 
are WYSIWYG interface, Topics, phrases, 
and hierarchical phrases. Coach marks. 
Fully-Integrated with Apples Guide Maker 
(distributed with Guide Composer), 
compiles scripts automatically, PlCTs In 
Panels. Generated Guide scripts are 
modifiable. Compiled files are 100% 
Apple Guide-compatible and royalty-free. 
Easy-to-use. $99 

MachTen UNIX for Macintosh and Power 
Macintosh MachTen is a Berkeley UNIX that 
runs an the Classic to the Power Mac, 
including Power Books and Duns! So, in 
addition lo all of the Macintosh applications, 
you get a Mach-based UNIX with pre¬ 
emptive multi-tasking MachTen extends the 
Macintosh operating system with UNIX 
networking and soltware development tools. 
The Macmlosli/UNIX integration is so strong 
thal you can even use Macintosh programs 
and utilities on UNIX data, and UNIX 
programs and utilities on Macintosh files. 
Full internet protocol support ensures fast, 
easy client and server NFS, e-mail, and file 
transfer belween the Macintosh and all TCP- 
based entities on your network BuilHn 
internet services include domain name 
service, POP matt service, internet routing, 
SLIP ft PPP, and Web service Full X11R5 
support wilh Mntif for deveinping X 
applications and a high performance X 
server for using your Mac as an X terminal. 
MachTen - Power UNIX $695 Personal 
MachTcn (for 68K Macs) $495 
Professional MachTen (for 68K Macs) $695 
MachTen X Window Software $350. 

Roaster ORt" See page 100 


Geekware hy Mctrowerks 
Mousepad SB 95 

Geekware Hawaiian Classic.$7.95 

Blood, Sweat ft Cade Black 
Long Sleeve Shirt $14 95 

Cross Platform White 
Short Sleeve Shirt $1495 
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TIPS & 
TIDBITS 


By Steve Sisak , Contributing Editor 




Mere is a handy function for making sure 
iliui an iifickletable 'file from heir doesn't 
gel in die way during program execution, just move it to 
the Trash, Itils only works when the file is on the same 
volume as the Trash, however. 

Greg Book 

File BpTnshFilch 

AlHTtrtlltTftl 


FSpTrashFilr h 

history 4 : 
HHxlUicd 
created: 


xxjxxjxx 

u mm 


vvlto arc you? wfaaf did you do? 
grtg puoic 


(ireg Poole 
Vital Fmages, Inc. 
emu i t : grcg@v(talim*gcs.com 

•444* *44*4444*4*f4*4t *#444**«444wi»M*PP 

//pragma once 

fdef _cplusplutj 

extern i 
fend If 

extern OSErr FSpTrashFilet FSSpecFtr file ); 

Pifdef _c p 1 lie plus 

1 

lendif 


Fite; I^pTnisliHtex 


Move 4 Ok to the trash if it is not possible to delete it 
Cun only move ilk to the trash if it is on the same volume 
as the file to be deleted. 


Ili■144 IfI I••»ll ft t lilltl « I ■ 4 ■ » I X+a« H* I #* IX I ft L«* »#« ■ ft# I Mi IAft«U*l J 


//include <Fulders.h> 

//include ’'FSpTraEhFile.h’ 1 

OSErr FSpTr* 0 hFUe( FSSpecFtr theFile ) 

I 

OSErr theErr " noKrr; 

short vRefKura; 

long dir10: 

FSSpec spec; 

FSSpecFtr the!rash “ Sspec; 

//don't go any further if there isn't a file to deal with or if the 
// file w*s ildeted successfully 
// 

theErr FSpOeletei theFile J; 
if ( theErr — fnfErr |j theErr = noErr ) 
return noErr; 


//if we got this Ur. we hat) a problem deleting tin file. 

H don't worry, relax and just (rash it 

thelvrt - FindFolderE kOnSysteniMijk, kTrashFclderType, 

kDontCreateFoIder, &vRefNum, kdirlD ); 

if ( theErr = noErr ) 

theErr - FSMakeFSSpeeE vEefNum, dirID P *\p*, rbeTrash }; 
if t theErr = nuErr ) 

if ( theFile->vRe£Nuis t" theTraeh >vKefNum ) 
theErr = diffVolErr: 

if ( theErr = noErr } 

theErr = CatHove( theFtlr >v Ref Muir, theFiie->parID, 
theFile >name 4 thcTrasb >pcifll>* ihclrasb > tut mo ); 

return theErr; 

1 //cod FSpTntshFik 

// define TEST_TltASH_FT!J; tor a standalone ieM 

Id c f ino TEST_TMSH_Ff LE 

#if defined( TEST_TltASli_FiLE ) 

// local function prototypes 

static void InitTheMac( void ); 

at a tic Boolean fkoAFile( FSSpecFtr file ); 

3 Lillie void InilTbcMtie ( void ) 

* 


Continued on page 95 


i jend us \vttr tips or well install HtenBetterBusError 
on your machine! On the other hand we might just 
pay you $25 for each tip m use. or 550 for Tip of the 
Month, You can take your award in goods, 
subscriptions or US$. Make sure any code compiles, 
and send tips fund where to mail your tannings/ to 
our new Tips e-wait address at nps9mactech.com. 
See page torn for our other addresses. 
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He Should 
Have Used 
JAM? 


Macintosh *- 


Building Client/Server Applications Doesn’t Have to be Painful, 

Get JAM® 7 - a Smashing New Version! 


Windows 95 , 
Window MT t 
Windows 


Whether you are a business analyst or a top-seeded developer- JAM 7 makes it easy to develop and 
deploy industrial strength applications The newest release of JYAQTs industry-leading second 
generation dient/server tool gives you the features and flexibility you need to see complex projects 
successfully through from start to finish. . JAW 7 allows you to build dient/server applications on the 
Macintosh and deploy them across platforms including OS/2 Warp. Motif; Windows 3X t Windows 96* 
VAX/VMS, and virtually every implementation of UNIX And unlike the competition’s runtime-only Mac 
ports. JAM for the Macintosh provides a full application development environment with true Mac 
look and feel. So don't bear the pain of inadequate tods - get JAM and be a winner! 


JAM qeV 5 your Macintosh 

y Native Mode on Soth 65K and 
Power Macintosh 

/ True Mac Look and heel 

/ Portability to Windows 95* Motif 
05/2 Warp, and Character-mode 

/ depository Driven Development 




/ Access and Native Support for Oracle. 
Sybase* ODBC and more. 

/ Visual Object-based Development Environment 

/ Database Screen Wizard with Full 
Transaction Control 

/ Automatic SQL Generation 


‘ 


DKAJQL (51) 11 fl tfi 6229 * DLHMARY. (45) 33 31 55 77 < fCNiAHP (350] 0 1« 756 * f4A»CE (3?) 1 45 92 45 *4 * GFFMAHV (49) 411 T9 70 07 0 - IWYATMA 
(US) 1 242 116 - IHDU (51 > ftWJlIBa » i*SAj-L (*r?J 3 Si I A129 * ITALY {393 2 25 52 G5 2 * MLMCO 152] 5 SM 4500 - RLT554A \ 7 \ <105 36* 1934 
SJMJft A*A6 jA (9662) 171 67*9 - SrNiiA«l4.C {55} 220 B322 * SiOVfUiA (306) fit 1495 «H * hPAIN (34) I 994 CC21 . &WtDLM f+fl) I S6 10 ID 
MttTZfliLAW HO 21 »I 90*1 ■ THAI LAW [M) 2 513 3S59 ' fllC WCTllUtLAtiOS {31) 10 329 9214 - uNfTEG FiH«0(K>M {44} 171 914 fiCHM 

JAM O * rp§ii»t=™( Crpjtanart wf JYACC. 1#W. fltlwr tk* jtncifi*rE.j ai th 


Call 1-000-450-3313 

or E-mail: macjam^jy acc.com for a free demonstration kit. For international inquiries 
call: 1-212-207-7722 or FAX 1-212-60&-6753. Visit our Web site at http://wwwjyaco.com, 

u 


★★★★ 


J Y A C C 

Mectiriq tfvi Ittrufr; rf ptfr»*lfl1iql 

dikiitopirs for aw K? ye *9 



























































































































metrowerks 


1994 SOFTWARE 
PRODUCT 
OF THE YEAR 


To'order contact Metrowerks: 
voice: (512) 305-0400- fa*: <Dl2) 305-0440 e-mail: sates(£ 
World Wide Webr http://wwv». metro werks.co- 

Metrowe^s, the Metrowerks Logo,.P^/Pl^ntanet CodeWiwrior Ate rjpStftfecJ 'tffli 
AIL other companies and productive trademarks of their respective noldVgs; ai 















